Specifying Individual Panels and Panel Objects

The file panel-default-setup.entries contains sections that specify panels and panel contents. The panel-default-setup.entries file specifies values for schema keys. The panel-default-setup.entries file resides in the /etc/gconf/schemas directory.

The panel-default-setup.entries file is structured as follows:

1. An entrylist element that specifies the base path for all the keys in the file. The following excerpt from panel-default-setup.entries specifies /apps/panel/default_setup as the base path for keys:

   <entrylist base="/apps/panel/default_setup">

   For example, if the key general/toplevel_id_list is referred to in panel-default-setup.entries, the full path for the key is /apps/panel/default_setup/general/toplevel_id_list.

2. Keys that specify the general structure of panels, applets, and other panel objects in the desktop. The following keys specify the number of panels, panel objects, and applets that appear in the desktop:

   • general/toplevel_id_list

   • general/object_id_list

   • general/applet_id_list

   The keys also assign identifiers to each panel, panel object, and applet. For example, the following sample from panel-default-setup.entries specifies that one panel appears in the desktop:

   <entry>
         <key>general/toplevel_id_list</key>
         <schema_key>/schemas/apps/panel/general/toplevel_id_list</schema_key>
         <value>
           <list type="string">
             <value>
               <string>bottom_panel</string>
             </value>
           </list>
         </value>
       </entry>

   In the panel-default-setup.entries file, the identifier bottom_panel identifies the panel at the bottom of the screen.

3. Keys that specify the properties of the panels. The panel property keys are structured as follows:

   toplevels/panel-name/panel-property-key
   

   For example, the key toplevels/bottom_panel/size specifies the size of the bottom panel.

4. Keys that specify the panel objects, the panel object properties, and the panels in which the objects reside. For example, the following sample from panel-default-setup.entries specifies a Main Menu object at the left side of the bottom panel:

   <entry>
         <key>objects/main_menu/object_type</key>
         <schema_key>/schemas/apps/panel/objects/object_type</schema_key>
         <value>
           <string>menu-object</string>
         </value>
       </entry>
       <entry>
         <key>objects/main_menu/toplevel_id</key>
         <schema_key>/schemas/apps/panel/objects/toplevel_id</schema_key>
         <value>
           <string>bottom_panel</string>
         </value>
       </entry>
       <entry>
         <key>objects/main_menu/position</key>
         <schema_key>/schemas/apps/panel/objects/position</schema_key>
         <value>
           <int>0</int>
         </value>
       </entry>

5. Keys that specify the applets, the applet preferences, and the panels in which the applets reside. For example, the following sample from panel-default-setup.entries specifies the Window List applet, in the bottom panel:

   <entry>
         <key>applets/window_list/object_type</key>
         <schema_key>/schemas/apps/panel/objects/object_type</schema_key>
         <value>
           <string>bonobo-applet</string>
         </value>
       </entry>
       <entry>
         <key>applets/window_list/toplevel_id</key>
         <schema_key>/schemas/apps/panel/objects/toplevel_id</schema_key>
         <value>
           <string>bottom_panel</string>
         </value>
       </entry>
       <entry>
         <key>applets/window_list/position</key>
         <schema_key>/schemas/apps/panel/objects/position</schema_key>
         <value>
           <int>3</int>
         </value>
       </entry>
   .
   .
   .
       <entry>
         <key>applets/window_list/bonobo_iid</key>
         <schema_key>/schemas/apps/panel/objects/bonobo_iid_type</schema_key>
         <value>
           <string>OAFIID:GNOME_WindowListApplet</string>
         </value>
       </entry>

   The OAFIID is a unique identifier for an applet. To find the OAFIID for a particular applet, see the .server file for the applet in the /usr/lib/bonobo/servers directory. For example, the following excerpt from GNOME_Wncklet_Factory.server shows the OAFIID for the Window List applet:

   <oaf_server iid="OAFIID:GNOME_WindowListApplet" 
   type="factory" location="OAFIID:GNOME_Wncklet_Factory">