summaryrefslogtreecommitdiffstats
path: root/gnome2-user-guide/C/gospanel.xml
blob: a6402cd0ebfb8d01fd21f65fe1c5ed9d374c6706 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110




<chapter id="gospanel-1">
<title>Working With Panels</title>
<highlights><para>The information in this chapter describes how to use panels. 
</para></highlights>
<sect1 id="gospanel-2">
<title>Introducing Panels</title>
<indexterm><primary>panels</primary><secondary>introduction</secondary></indexterm>
<para>A panel is an area on your desktop from which you can run applications
and applets, and perform other tasks. When you start a session for the first
time, the desktop contains the following panels: </para>
<itemizedlist>
<listitem><para>Menu Panel</para></listitem>
<listitem><para>Edge panel at the bottom of the desktop</para></listitem>
</itemizedlist>
<para>The following sections describe these panels.</para>
<sect2 id="gospanel-6">
<title>Menu Panel</title>
<indexterm><primary>Menu Panel</primary><secondary>introduction</secondary>
</indexterm><indexterm><primary>panels</primary><secondary>Menu Panel</secondary>
<see>Menu Panel</see></indexterm><para>The Menu Panel stretches the full length
of the top edge of your screen. The Menu Panel includes textual rather than
graphical menus. <xref linkend="gospanel-FIG-60"/> shows the Menu Panel. Your
system administrator might have set your default Menu Panel according to your
local requirements, so you might see a slightly different Menu Panel.</para>
<figure id="gospanel-FIG-60">
<title>Typical Menu Panel</title>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/menu_panel.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows the default Menu Panel. The context describes the graphic.
</phrase>
  </textobject>
</mediaobject>
</screenshot>
</figure>
<indexterm><primary>Menu Panel</primary><secondary>default contents</secondary>
</indexterm><para>The typical Menu Panel contains the following objects: 
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC3" colwidth="30.95*"/>
<colspec colname="COLSPEC4" colwidth="69.05*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Object</para></entry><entry valign="top"><para>
Description </para></entry></row>
</thead>
<tbody>
<row><entry valign="top"><para><guimenu>Applications</guimenu> menu</para></entry>
<entry valign="top"><para>The <guimenu>Applications</guimenu> menu contains
the standard GNOME applications.</para></entry></row>
<row><entry valign="top"><para><guimenu>Actions</guimenu> menu</para></entry>
<entry valign="top"><para>The <guimenu>Actions</guimenu> menu provides commands
that enable you to perform desktop tasks. </para></entry></row>
<row><entry colname="COLSPEC3"><para>Home folder launcher</para></entry><entry
colname="COLSPEC4"><para>Click on this launcher to open your home folder in
a <application>Nautilus</application> file manager window. </para></entry>
</row>
<row><entry colname="COLSPEC3"><para><application>Terminal</application> launcher
</para></entry><entry colname="COLSPEC4"><para>Click on this launcher to start
the <application>Terminal</application> application. <application>Terminal
</application> provides access to a UNIX command line.</para></entry></row>
<row><entry colname="COLSPEC3" valign="top"><para><application>Volume Control
</application> applet</para></entry><entry colname="COLSPEC4" valign="top"><para><application>
Volume Control</application> enables you to control the volume of the speaker
on your system.</para></entry></row>
<row><entry valign="top"><para><application>Clock</application> applet</para></entry>
<entry valign="top"><para><application>Clock</application> shows the current
time. Click on the time readout to display a menu of clock commands.</para></entry>
</row>
<row><entry colname="COLSPEC3" valign="top"><indexterm><primary>Menu Panel
</primary><secondary>window list icon</secondary></indexterm><para>Window
list icon</para></entry><entry colname="COLSPEC4" valign="top"><para>The window
list is a list of all your open windows. To give focus to a window, click
on the icon at the extreme right of the Menu Panel, then choose the window.
</para></entry></row>
</tbody>
</tgroup>
</informaltable>
<para>Unlike other types of panel, you can only have one Menu Panel at a time
on your desktop.</para>
</sect2>
<sect2 id="gospanel-3">
<title>Bottom Edge Panel</title>
<indexterm><primary>panels</primary><secondary>bottom edge panel</secondary>
<see>bottom edge panel</see></indexterm><indexterm><primary>bottom edge panel
</primary><secondary>introduction</secondary></indexterm><para>On startup,
an edge panel stretches the full length of the bottom edge of the desktop. <xref
linkend="gospanel-FIG-58"/> shows a typical bottom edge panel. Your system
administrator might have set your default bottom edge panel according to your
local requirements, so you might see a slightly different bottom edge panel. 
</para>
<figure id="gospanel-FIG-58">
<title>Typical Bottom Edge Panel</title>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/gnome_panel.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows the bottom edge panel. The context describes the graphic.
</phrase>
  </textobject>
</mediaobject>
</screenshot>
</figure>
<indexterm><primary>bottom edge panel</primary><secondary>default contents
</secondary></indexterm><para>The bottom edge panel contains the following
applets:</para>
<itemizedlist>
<listitem><para><application>Window List</application>: Displays a button
for each window that is open. <application>Window List</application> enables
you to minimize and restore windows.</para></listitem>
<listitem><para><application>Workspace Switcher</application>: Enables you
to navigate between your workspaces.</para></listitem>
</itemizedlist>
<para>You can change the behavior and appearance of your bottom edge panel
to suit your requirements. You can also add or remove objects from your bottom
edge panel. You can create multiple panels, and choose different properties,
objects, and backgrounds for each panel. You can also hide panels.</para>
</sect2>
</sect1>
<sect1 id="gospanel-5">
<title>Managing Your Panels</title>
<indexterm><primary>panels</primary><secondary>managing</secondary></indexterm>
<para>The following sections describe how to manage your panels.</para>
<sect2 id="gospanel-10">
<title>To Add a New Panel</title>
<indexterm><primary>panels</primary><secondary>adding new</secondary></indexterm>
<para>You can add different types of panels to your desktop. <xref linkend="gospanel-TBL-47"/>
lists the types of panel that you can add, and their characteristics. </para>
<table frame="topbot" id="gospanel-TBL-47">
<title>Types of Panel</title>
<tgroup cols="3" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="24.28*"/>
<colspec colname="COLSPEC1" colwidth="37.36*"/><colspec colname="COLSPEC2"
colwidth="37.36*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Panel Type</para></entry><entry
valign="top"><para>Snap Behavior </para></entry><entry valign="top"><para>
Size</para></entry></row>
</thead>
<tbody>
<row><entry colname="COLSPEC0" valign="top"><para>Corner Panel</para></entry>
<entry colname="COLSPEC1" valign="top"><para>Snaps to one of the edges of
the screen, but can only snap to the center or the corner of the edge. </para></entry>
<entry colname="COLSPEC2" valign="top"><para>Stretches as much as required
to display the objects on the panel.</para></entry></row>
<row><entry valign="top"><para>Edge Panel</para></entry><entry valign="top"><para>
Snaps to one of the edges of the screen. The startup panel at the bottom of
the desktop is an example of an edge panel. </para></entry><entry valign="top"><para>
Stretches the full length of the edge that the panel snaps to.</para></entry>
</row>
<row><entry valign="top"><para>Floating Panel</para></entry><entry valign="top"><para>
Does not snap to anything. You can place a floating panel anywhere on your
desktop.</para></entry><entry valign="top"><para>Stretches as much as required
to display the objects on the panel.</para></entry></row>
<row><entry valign="top"><para>Sliding Panel</para></entry><entry valign="top"><para>
Snaps to one of the edges of the screen, can snap to any point on the edge.
</para></entry><entry valign="top"><para>Stretches as much as required to
display the objects on the panel.</para></entry></row>
<row><entry colname="COLSPEC0"><para>Menu Panel</para></entry><entry colname="COLSPEC1"><para>
Snaps to the top edge of the screen. You cannot move the Menu Panel.</para></entry>
<entry colname="COLSPEC2"><para>Stretches the full length of the top edge
of the screen. You can only have one Menu Panel on your desktop.</para></entry>
</row>
</tbody>
</tgroup>
</table>
<para>To add a panel perform the following steps:</para>
<orderedlist>
<listitem><para>Right-click on a vacant space on any panel, then choose <guimenuitem>
New Panel</guimenuitem>.</para></listitem>
<listitem><para>Choose the type of panel that you want to add. The new panel
is added to the desktop. The new panel contains no objects, except for a Menu
Panel. </para>
<para>You can customize the new panel to suit your preferences.</para></listitem>
</orderedlist>
</sect2>
<sect2 id="gospanel-11">
<title>To Interact With a Panel</title>
<indexterm><primary>panels</primary><secondary>interacting with</secondary>
</indexterm><para>To interact with a panel, you must left-click, middle-click,
or right-click on a vacant space on the panel. You can also middle-click or
right-click on one of the hide buttons to select the panel, if the panel has
no vacant space. If the hide buttons are not visible on a panel, modify the
properties of the panel so that the hide buttons are visible. </para>
<para>You use the mouse buttons to interact with a panel in the following
ways:</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="30.65*"/>
<colspec colname="COLSPEC1" colwidth="69.35*"/>
<tbody>
<row><entry valign="top"><para>Middle-click</para></entry><entry valign="top"><para>
Enables you to grab a panel, then drag the panel to a new location.</para></entry>
</row>
<row><entry valign="top"><para>Right-click</para></entry><entry valign="top"><para>
Opens the panel popup menu.</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</sect2>
<sect2 id="gospanel-12">
<title>To Move a Panel</title>
<indexterm><primary>panels</primary><secondary>moving</secondary></indexterm>
<para>You can move panels to different locations on your desktop. To move
a panel, middle-click and hold on any vacant space on the panel, then drag
the panel to the new location.</para>
<para>When you drag a floating panel, the panel follows the mouse pointer.
The panel does not snap to any part of the desktop. When you drag a corner
panel, an edge panel, or a sliding panel, the panel snaps to the edge of the
screen.</para>
<note><para>You cannot move the Menu Panel.</para>
</note>
</sect2>
<sect2 id="gospanel-7">
<title>To Hide a Panel</title>
<indexterm><primary>panels</primary><secondary>hiding</secondary></indexterm>
<para>You can hide or show panels, except for the Menu Panel. To hide a panel,
use a hide button. If the hide buttons are not visible on a panel, modify
the panel properties so that the hide buttons are visible. </para>
<para>Hide buttons are at either end of a panel. The hide buttons contain
an optional arrow icon. The following illustration shows hide buttons. </para>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/four_hide_button.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows a horizontal panel and a vertical panel, both with hide buttons.
</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para>To hide a panel, click on one of the hide buttons. The panel reduces
in the direction of the arrow on the hide button. The hide button at the other
end of the panel remains visible.</para>
<para>To show a hidden panel again, click on the visible hide button. The
panel expands in the direction of the arrow on the hide button. Both hide
buttons are now visible.</para>
<para>You can set a panel to autohide. When you set autohide, the panel hides
automatically when the mouse is not pointing to the panel. The panel reappears
when you point to the part of the screen where the panel resides. To set your
panel to autohide, modify the properties of the panel.</para>
<note><para>On a corner panel, the behavior of the hide buttons is slightly
different. If the panel is in one of the corners of the screen, you can use
the hide buttons as follows:</para>
<itemizedlist>
<listitem><para>To hide the panel, click the hide button that is closest to
the edge of the screen, as normal.</para></listitem>
<listitem><para>To move the panel to the opposite corner of the screen, click
the hide button that is farthest from the edge of the screen.</para></listitem>
</itemizedlist>
</note>
</sect2>
<sect2 id="gospanel-28">
<title>To Modify Panel Properties</title>
<indexterm><primary>panels</primary><secondary>modifying properties</secondary>
</indexterm><para>To modify preferences for all panels, choose <menuchoice>
<guimenu>Applications</guimenu><guisubmenu>Desktop Preferences
</guisubmenu><guisubmenu>Advanced</guisubmenu><guimenuitem>Panel</guimenuitem>
</menuchoice>, then make the changes that you require. For example, you can
specify various settings related to the appearance and behavior of panel objects. 
</para>
<para>You can also modify properties for each individual panel. You can change
the features for each panel, such as the type of the panel, the hide behavior,
and the visual appearance. </para>
<note><para>You cannot modify properties for the Menu Panel.</para>
</note>
<para>To modify the properties of a panel perform the following steps: </para>
<orderedlist>
<listitem><para>Right-click on a vacant space on the panel, then choose <guimenuitem>
Properties</guimenuitem> to display the <guilabel>Panel Properties</guilabel>
dialog. </para>
<para>The <guilabel>Panel Properties</guilabel> dialog contains the following
tabbed sections: </para>
<itemizedlist>
<listitem><para><guilabel><replaceable>Panel_type</replaceable> Panel</guilabel></para>
</listitem>
<listitem><para><guilabel>Background</guilabel></para></listitem>
</itemizedlist>
</listitem>
<listitem><para>To modify panel size, position, and hiding properties, click
on the <guilabel><replaceable>Panel_type</replaceable> Panel</guilabel> tab.
The following table describes the dialog elements on the <guilabel><replaceable>
Panel_type</replaceable> Panel</guilabel> tabbed section: </para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="28.57*"/>
<colspec colname="COLSPEC1" colwidth="71.43*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Dialog Element</para></entry><entry
valign="top"><para>Description </para></entry></row>
</thead>
<tbody>
<row><entry colname="COLSPEC0"><para><guilabel>Position</guilabel></para></entry>
<entry colname="COLSPEC1"><para>Select the position of the panel on your desktop.
Click on the required position for the panel. </para></entry></row>
<row><entry valign="top"><para><guilabel>Size</guilabel></para></entry><entry
valign="top"><para>Select the size of the panel.</para></entry></row>
<row><entry valign="top"><para><guilabel>Orient horizontally</guilabel></para></entry>
<entry valign="top"><para>Floating panel only. Select this option to display
the panel horizontally. </para></entry></row>
<row><entry valign="top"><para><guilabel>Orient vertically</guilabel></para></entry>
<entry valign="top"><para>Floating panel only. Select this option to display
the panel vertically.</para></entry></row>
<row><entry colname="COLSPEC0"><para><guilabel>Horizontal offset</guilabel></para></entry>
<entry colname="COLSPEC1"><para>Floating panel only. Use the spin box to specify
the distance of the panel from the left edge of the desktop. </para></entry>
</row>
<row><entry colname="COLSPEC0"><para><guilabel>Vertical offset</guilabel></para></entry>
<entry colname="COLSPEC1"><para>Floating panel only. Use the spin box to specify
the distance of the panel from the top edge of the desktop. </para></entry>
</row>
<row><entry valign="top"><para><guilabel>Screen edge offset</guilabel></para></entry>
<entry valign="top"><para>Sliding panel only. Use this spin box to specify
the distance between your panel and the edge of the desktop, in pixels. </para></entry>
</row>
<row><entry valign="top"><para><guilabel>Autohide</guilabel></para></entry>
<entry valign="top"><para>Select this option to enable autohide. </para></entry>
</row>
<row><entry valign="top"><para><guilabel>Show hide buttons</guilabel></para></entry>
<entry valign="top"><para>Select this option to display hide buttons on your
panel.</para></entry></row>
<row><entry valign="top"><para><guilabel>Arrows on hide button </guilabel></para></entry>
<entry valign="top"><para>Select this option to display arrows on the hide
buttons, if the hide button is enabled.</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem><para>To modify the panel background, click on the <guilabel>Background
</guilabel> tab. The <guilabel>Background</guilabel> tabbed section contains
the following elements: </para>
<informaltable frame="topbot">
<tgroup cols="3" colsep="0" rowsep="0"><colspec colwidth="27.00*"/><colspec
colname="COLSPEC5" colwidth="29.14*"/><colspec colname="COLSPEC6" colwidth="42.86*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Dialog Element</para></entry><entry
namest="COLSPEC5" nameend="COLSPEC6" valign="top"><para>Description</para></entry>
</row>
</thead>
<tbody>
<row><entry valign="top"><para><guilabel>Background Type</guilabel></para></entry>
<entry namest="COLSPEC5" nameend="COLSPEC6" valign="top"><para>Choose the
type of background for the panel. The choices are as follows:</para><itemizedlist>
<listitem><para><guilabel>Default</guilabel>: The default background type.
The standard background depends on the settings in <menuchoice><guimenu>Applications
</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>
Theme</guimenuitem></menuchoice>. </para></listitem>
<listitem><para><guilabel>Color</guilabel>: Enables you to choose a color
for the panel background.</para></listitem>
<listitem><para><guilabel>Image</guilabel>: Enables you to choose an image
for the panel background. </para></listitem>
</itemizedlist></entry></row>
<row><entry valign="top"><para><guilabel>Background Color</guilabel></para></entry>
<entry namest="COLSPEC5" nameend="COLSPEC6" valign="top"><para>If <guilabel>
Background Type</guilabel> is <guilabel>Color</guilabel>, click on the <guibutton>
Color to use</guibutton> button to display the color selector dialog. Choose
the color that you require from the color selector dialog. </para></entry>
</row>
<row><entry morerows="4" valign="top"><para><guilabel>Image</guilabel></para></entry>
<entry namest="COLSPEC5" nameend="COLSPEC6" valign="top"><para>If <guilabel>
Background Type</guilabel> is <guilabel>Image</guilabel>, choose the image
to use on the background of the panel. Specify the following settings for
the image background:</para></entry></row>
<row><entry valign="top"><para><guilabel>Do not scale image to fit</guilabel></para></entry>
<entry valign="top"><para>Select this option to tile the background image
to fit the panel background.</para></entry></row>
<row><entry valign="top"><para><guilabel>Scale image</guilabel></para></entry>
<entry valign="top"><para>Select this option to scale the background image
to fit the panel background. The width-to-height ratio of the image is retained. 
</para></entry></row>
<row><entry valign="top"><para><guilabel>Stretch image</guilabel></para></entry>
<entry valign="top"><para>Select this option to stretch the background image
to fit the panel background. The width-to-height ratio of the image is not
retained. </para></entry></row>
<row><entry valign="top"><para><guilabel>Rotate image for vertical panels 
</guilabel></para></entry><entry valign="top"><para>Select this option to
rotate the background image on a vertical panel.</para></entry></row>
</tbody>
</tgroup>
</informaltable>
<para>You can also drag a color or image on to a panel to set the color or
image as the background of the panel. For more information, see <xref linkend="gospanel-61"/>.
</para></listitem>
<listitem><para>Click <guibutton>Close</guibutton> to close the <guilabel>
Panel Properties</guilabel> dialog.</para></listitem>
</orderedlist>
<sect3 id="gospanel-61">
<title>To Drag a Color or Image to the Background of a Panel</title>
<indexterm><primary>panels</primary><secondary>changing background</secondary>
</indexterm><para>You can drag a color or image on to a panel to set the color
or image as the background of the panel. You can drag a color or image from
many applications. For example, you can drag a color from the <application>
Nautilus</application> file manager to a panel to set the color as the background
of the panel. You can also drag a color from any color selector dialog.</para>
<para>You can drag an image to a panel to set the image as the background
of the panel. You can also drag pattern images from the <application>Nautilus
</application> file manager application to set the background of the panel.
</para>
</sect3>
</sect2>
<sect2 id="gospanel-31">
<title>To Delete a Panel</title>
<indexterm><primary>panels</primary><secondary>deleting</secondary></indexterm>
<para>To delete a panel from the desktop, right-click on the panel that you
want to delete, then choose <menuchoice><guimenuitem>Delete This Panel</guimenuitem>
</menuchoice>.</para>
<note><para>You must always have at least one panel on your desktop. If you
have only one panel on your desktop, you cannot delete that panel.</para>
</note>
</sect2>
</sect1>
<sect1 id="gospanel-8">
<title>Panel Objects</title>
<indexterm><primary>panels</primary><secondary>panel objects</secondary><see>
panel objects</see></indexterm><para>This section describes the objects that
you can add to your panels, and use from your panels.</para>
<sect2 id="gospanel-100">
<title>Interacting With Panel Objects</title>
<indexterm><primary>panel objects</primary><secondary>interacting with</secondary>
</indexterm><para>You use the mouse buttons to interact with a panel object
in the following ways:</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="30.65*"/>
<colspec colname="COLSPEC1" colwidth="69.35*"/>
<tbody>
<row><entry colname="COLSPEC0" valign="top"><para>Left-click</para></entry>
<entry colname="COLSPEC1" valign="top"><para>Launches the panel object.</para></entry>
</row>
<row><entry valign="top"><para>Middle-click</para></entry><entry valign="top"><para>
Enables you to grab an object, then drag the object to a new location.</para></entry>
</row>
<row><entry valign="top"><para>Right-click</para></entry><entry valign="top"><para>
Opens the panel object popup menu.</para></entry></row>
</tbody>
</tgroup>
</informaltable>
<para>You interact with applet panel objects in a different way. For more
information, see <xref linkend="gospanel-39"/>.</para>
</sect2>
<sect2 id="gospanel-15">
<title>To Add an Object to a Panel</title>
<indexterm><primary>panel objects</primary><secondary>adding</secondary></indexterm>
<para>You can add an object to a panel in several ways, as follows: </para>
<itemizedlist>
<listitem><para>From the panel popup menu</para>
<para>Right-click on a vacant space on a panel to open the panel popup menu.
The panel popup menu contains an <guisubmenu>Add to Panel</guisubmenu> submenu.
The <guisubmenu>Add to Panel</guisubmenu> submenu enables you to add the following
objects to your panels: <itemizedlist>
<listitem><para>Accessory applets</para></listitem>
<listitem><para>Amusement applets</para></listitem>
<listitem><para>Internet applets</para></listitem>
<listitem><para>Multimedia applets</para></listitem>
<listitem><para>Utility applets</para></listitem>
<listitem><para>Launchers</para></listitem>
<listitem><para>GNOME Menu</para></listitem>
<listitem><para>Drawers</para></listitem>
<listitem><para><guibutton>Log Out</guibutton> button</para></listitem>
<listitem><para><guibutton>Lock</guibutton> button</para></listitem>
</itemizedlist></para></listitem>
<listitem><para>From any menu</para>
<para>When you right-click on a launcher in any menu, a popup menu for the
launcher opens. You can use this popup menu to add the launcher to a panel. 
</para>
<para>You can also drag menus, launchers, and applets from menus to panels. 
</para></listitem>
<listitem><para>From the file manager</para>
<para>Each launcher and applet corresponds to a <filename>.desktop</filename>
file. You can drag the <filename>.desktop</filename> file on to your panels
to add the launcher or applet to the panel. </para>

<para>Each menu corresponds to a directory. You can drag the directory on
to your panels to add the directory to the panel as a menu object.</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 id="gospanel-9">
<title>To Modify the Properties of an Object</title>
<indexterm><primary>panel objects</primary><secondary>modifying properties
</secondary></indexterm><para>Some panel objects have a set of associated
properties. The properties are different for each type of object. The properties
specify details such as the following: <itemizedlist>
<listitem><para>The command that starts a launcher application.</para></listitem>
<listitem><para>The location of the source files for a menu.</para></listitem>
<listitem><para>The icon that represents the object.</para></listitem>
</itemizedlist></para>
<para>To modify the properties of an object perform the following steps: 
</para>
<orderedlist>
<listitem><indexterm><primary>panel object popup menu, illustration</primary>
</indexterm><para>Right-click on the object to open the panel object popup
menu, as shown in <xref linkend="gospanel-FIG-54"/>.</para>
<figure id="gospanel-FIG-54">
<title>Panel Object Popup Menu</title>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/panel_object_popup_menu.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows panel object popup menu. Menu items:  Properties, Help, Remove From Panel, Move.
</phrase>
  </textobject>
</mediaobject>
</screenshot>
</figure>
</listitem>
<listitem><para>Choose <guimenuitem>Properties</guimenuitem>. Use the <guilabel>
Properties</guilabel> dialog to modify the properties as required. The properties
in the <guilabel>Properties</guilabel> dialog depend on which object you select
in step 1. </para></listitem>
<listitem><para>Click <guibutton>OK</guibutton> to apply the changes, then
close the <guilabel>Properties</guilabel> dialog.</para></listitem>
</orderedlist>
</sect2>
<sect2 id="gospanel-32">
<title>To Move a Panel Object</title>
<indexterm><primary>panel objects</primary><secondary>moving</secondary></indexterm>
<para>You can move panel objects within a panel, and from one panel to another
panel. You can also move objects between panels and drawers.</para>
<para>To move a panel object, middle-click and hold on the object and drag
the object to a new location. When you release the middle mouse button, the
object anchors at the new location.</para>
<para>Alternatively, you can use the panel object popup menu to move an object,
as follows: </para>
<orderedlist>
<listitem><para>Right-click on the object, then choose <guimenuitem>Move</guimenuitem>.
</para></listitem>
<listitem><para>Point to the new location for the object, then click any mouse
button to anchor the object to the new location. This location can be on any
panel that is currently on your desktop. </para></listitem>
</orderedlist>
<para>Movement of a panel object affects the position of other objects on
the panel. To control how objects move on a panel, you can specify a movement
mode. To specify the movement mode, press one of the following keys as you
move the panel object:</para>
<informaltable frame="topbot">
<tgroup cols="3" colsep="0" rowsep="0"><colspec colname="COLSPEC2" colwidth="15.00*"/>
<colspec colname="COLSPEC1" colwidth="30.00*"/><colspec colname="COLSPEC3"
colwidth="54.00*"/>
<thead>
<row rowsep="1"><entry colname="COLSPEC2" valign="top"><para>Key</para></entry>
<entry valign="top"><para>Movement Mode</para></entry><entry colname="COLSPEC3"
valign="top"><para>Description</para></entry></row>
</thead>
<tbody>
<row><entry colname="COLSPEC2" valign="top"><para>No key</para></entry><entry
colname="COLSPEC1" valign="top"><para>Switched movement</para></entry><entry
colname="COLSPEC3" valign="top"><para>The object swaps places with other panel
objects. Switched movement is the default movement mode.</para></entry></row>
<row><entry colname="COLSPEC2" valign="top"><para><keycap>Alt</keycap> key
</para></entry><entry valign="top"><para>Free movement</para></entry><entry
colname="COLSPEC3" valign="top"><para>The object jumps over other panel objects
into the next vacant space on the panel.</para></entry></row>
<row><entry colname="COLSPEC2" valign="top"><para><keycap>Shift</keycap> key 
</para></entry><entry valign="top"><para>Push movement</para></entry><entry
colname="COLSPEC3" valign="top"><para>The object pushes other panel objects
further along the panel. </para></entry></row>
</tbody>
</tgroup>
</informaltable>
</sect2>
<sect2 id="gospanel-33">
<title>To Remove a Panel Object</title>
<indexterm><primary>panel objects</primary><secondary>removing</secondary>
</indexterm><para>To remove an object from a panel right-click on the object
to open the panel object popup menu, then choose <guimenuitem>Remove From
Panel</guimenuitem>. </para>
</sect2>
</sect1>
<sect1 id="gospanel-17">
<title>Applets</title>
<indexterm><primary>applets</primary><secondary>introduction</secondary></indexterm>
<indexterm><primary>panel objects</primary><secondary>applets</secondary>
<see>applets</see></indexterm><para>An applet is a small application whose
user interface resides within a panel. You use the applet panel object to
interact with the applet. For example, the following figure shows the following
applets, from left to right: </para>
<itemizedlist>
<listitem><para><application>Window List</application>: Displays the windows
currently open on your system.</para></listitem>
<listitem><para><application>CD Player</application>: Enables you to control
the compact disc player on your system.</para></listitem>
<listitem><para><application>Volume Control</application>: Enables you to
control the volume of the speaker on your system.</para></listitem>
</itemizedlist>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/sample_applet.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows sample applets. The context describes the graphic.
</phrase>
  </textobject>
</mediaobject>
</screenshot>
<sect2 id="gospanel-40">
<title>To Add an Applet to a Panel</title>
<indexterm><primary>applets</primary><secondary>adding to panel</secondary>
</indexterm><para>You can add an applet to a panel from the panel popup menu.
Right-click on any vacant space on the panel to open the panel popup menu.
Choose <guimenu>Add to Panel</guimenu>, then choose the applet that you want
to add from one of the following submenus:</para>
<itemizedlist>
<listitem><para><guimenu>Accessories</guimenu></para></listitem>
<listitem><para><guimenu>Amusements</guimenu></para></listitem>
<listitem><para><guimenu>Internet</guimenu></para></listitem>
<listitem><para><guimenu>Multimedia</guimenu></para></listitem>
<listitem><para><guimenu>Utility</guimenu></para></listitem>
</itemizedlist>
<para>Alternatively, drag the applet from the submenu on to the panel. </para>
</sect2>
<sect2 id="gospanel-39">
<title>To Select an Applet</title>
<indexterm><primary>applets</primary><secondary>selecting</secondary></indexterm>
<para>To modify the properties of an applet, you must first right-click on
the applet to display the panel object popup menu. To move an applet, you
must middle-click on the applet. </para>
<para>Some restrictions apply on where you can click on an applet in order
to display the panel object popup menu, or to move the applet, as follows: 
</para>
<itemizedlist>
<listitem><para>Some applets have popup menus of applet-specific commands
that open when you right-click on particular parts of the applet. For example,
the <application>Window List</application> applet has a vertical handle on
the left side, and buttons that represent your windows on the right side.
To open the panel object popup menu for the <application>Window List</application>
applet, you must right-click on the handle. If you right-click on a button
on the right side, a popup menu for the button opens.</para></listitem>
<listitem><para>Some applets have areas that you cannot use to select the
applet. For example, the <application>Command Line</application> applet has
a field in which you enter commands. You cannot middle-click or right-click
on this field to select the applet. Instead, middle-click or right-click on
another part of the applet. </para></listitem>
</itemizedlist>
</sect2>
<sect2 id="gospanel-41">
<title>To Modify Preferences for an Applet</title>
<indexterm><primary>applets</primary><secondary>modifying preferences</secondary>
</indexterm><para>To modify the preferences for an applet perform the following
steps: </para>
<orderedlist>
<listitem><para>Right-click on the applet, then choose <guimenuitem>Preferences
</guimenuitem>. Use the <guilabel>Preferences</guilabel> dialog to modify
the preferences as required. The preferences for applets vary depending on
the applet.</para></listitem>
<listitem><para>Click <guibutton>Close</guibutton> to close the <guilabel>
Preferences</guilabel> dialog.</para></listitem>
</orderedlist>
</sect2>
</sect1>
<sect1 id="gospanel-16">
<title>Launchers</title>
<indexterm><primary>panel objects</primary><secondary>launchers</secondary>
<see>launchers</see></indexterm><para>When you click on a launcher, you initiate
one of the following actions: </para>
<itemizedlist>
<listitem><para>Start a particular application.</para></listitem>
<listitem><para>Execute a command.</para></listitem>
<listitem><para>Open a folder in a file manager window.</para></listitem>
<listitem><para>Open a browser at a particular <firstterm>Uniform Resource
Locator</firstterm> (URL). A URL is the address of a particular
location on the Web.</para></listitem>
</itemizedlist>
<para>You can find launchers in the following places on the desktop:</para>
<itemizedlist>
<listitem><para>Panels: On panels, launchers are represented by icons.</para>
</listitem>
<listitem><para>Menus: On menus, launchers are represented by menu items.
The menu items usually have an icon beside the menu item.</para></listitem>
<listitem><para>Desktop background: On the desktop background, launchers are
represented by icons.</para></listitem>
</itemizedlist>
<para>You can modify the properties of a launcher. For example, the properties
of a launcher include the name of the launcher, the icon that represents the
launcher, and how the launcher runs. </para>
<sect2 id="gospanel-34">
<title>To Add a Launcher to a Panel</title>
<indexterm><primary>launchers</primary><secondary>adding to panel</secondary>
</indexterm><para>You can add a launcher to a panel in one of the following
ways:</para>
<itemizedlist>
<listitem><para>From the panel popup menu</para>
<para>To create a new launcher, right-click on any vacant space on the panel,
then choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>
Launcher</guimenuitem></menuchoice>. A <guilabel>Create Launcher</guilabel>
dialog is displayed. For more information on how to complete this dialog,
see <xref linkend="gospanel-52"/>.</para>
<para>Alternatively, to add an existing launcher to the panel, choose <menuchoice>
<guimenu>Add to Panel</guimenu><guimenuitem>Launcher from menu</guimenuitem>
</menuchoice> from the panel popup men. Choose the launcher that you want
to add from the menu.</para></listitem>
<listitem><para>From any menu</para>
<para>To add a launcher to a panel from any menu, perform one of the following
steps:<itemizedlist>
<listitem><para>Open the menu that contains the launcher from the panel where
you want the launcher to reside. Right-click on the title of the launcher.
Choose <guimenuitem>Add this launcher to panel</guimenuitem>. </para></listitem>
<listitem><para>Open a menu that contains the launcher. Drag the launcher
on to the panel. </para></listitem>
</itemizedlist></para></listitem>
<listitem><para>From the file manager</para>
<para>To add a launcher to a panel from the file manager, find the <filename>
.desktop</filename> file for the launcher in your file system. To add the
launcher drag the <filename>.desktop</filename> file to the panel. </para>
</listitem>
</itemizedlist>
<sect3 id="gospanel-52">
<title>To Create a Launcher With the Create Launcher Dialog</title>
<para>To create a launcher with the <guilabel>Create Launcher</guilabel> dialog
perform the following steps: </para>
<orderedlist>
<listitem><para>Right-click on any part of a panel to open the panel popup
menu. Choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>
Launcher</guimenuitem></menuchoice> to display the <guilabel>Create Launcher
</guilabel> dialog. The dialog displays the <guilabel>Basic</guilabel> tabbed
section.</para></listitem>
<listitem><para>Enter the properties of the launcher in the dialog. The following
table describes the dialog elements on the <guilabel>Basic</guilabel> tabbed
section: </para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="26.19*"/>
<colspec colname="COLSPEC1" colwidth="73.81*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Dialog Element</para></entry><entry
valign="top"><para>Description </para></entry></row>
</thead>
<tbody>
<row><entry valign="top"><para><guilabel>Name</guilabel></para></entry><entry
valign="top"><para>Use this text box to specify the name of the launcher.
You can use the <guilabel>Advanced</guilabel> tab to add translations of the
name. This name is the name that appears when you add the launcher to a menu
or to the desktop background. </para></entry></row>
<row><entry colname="COLSPEC0"><para><guilabel>Generic name</guilabel></para></entry>
<entry colname="COLSPEC1"><para>Use this text box to specify the class of
application to which the launcher belongs. For example, you might type <userinput>
Text Editor</userinput> in this text box for a <application>gedit</application>
launcher. You can use the <guilabel>Advanced</guilabel> tab to add translations
of the generic name.</para></entry></row>
<row><entry valign="top"><para><guilabel>Comment</guilabel></para></entry>
<entry valign="top"><para>Use this text box to specify a short description
of the launcher. The comment is displayed as a tooltip when you point to the
launcher icon on the panel. You can use the <guilabel>Advanced</guilabel>
tabbed section to add translations of the comment. </para></entry></row>
<row><entry valign="top"><para><guilabel>Command</guilabel></para></entry>
<entry valign="top"><para>Use this field to specify a command to execute when
you click on the launcher. </para></entry></row>
<row><entry valign="top"><para><guilabel>Type</guilabel></para></entry><entry
valign="top"><para>Use this drop-down combination box to specify the type
of launcher. Select from the following: </para><itemizedlist>
<listitem><para><guilabel>Application</guilabel>: Select this option to create
a launcher that starts an application.</para></listitem>
<listitem><para><guilabel>Link</guilabel>:  Select this option to create a
launcher that links to a file, folder, or FTP site.</para></listitem>
</itemizedlist></entry></row>
<row><entry valign="top"><para><guilabel>Icon</guilabel></para></entry><entry
valign="top"><para>Choose an icon to represent the launcher. To choose an
icon, click on the <guibutton>No Icon</guibutton> button. An icon selector
dialog is displayed. Choose an icon from the dialog. Alternatively, to choose
an icon from another directory, click <guibutton>Browse</guibutton>. When
you choose an icon, click <guibutton>OK</guibutton>. </para></entry></row>
<row><entry valign="top"><para><guilabel>Run in Terminal</guilabel></para></entry>
<entry valign="top"><para>Select this option to run the application or command
in a terminal window. Choose this option for an application or command that
does not create a window in which to run.</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem><para>To set advanced properties for the launcher, click on the <guilabel>
Advanced</guilabel> tab. The <guilabel>Launcher Properties</guilabel> dialog
displays the <guilabel>Advanced</guilabel> tabbed section.</para></listitem>
<listitem><para>Enter the advanced properties of the launcher in the dialog.
The following table describes the dialog elements on the top part of the <guilabel>
Advanced</guilabel> tabbed section: </para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="32.03*"/><colspec
colwidth="67.97*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Dialog Element</para></entry><entry
valign="top"><para>Description </para></entry></row>
</thead>
<tbody>
<row><entry valign="top"><para><guilabel>Try this before using</guilabel></para></entry>
<entry valign="top"><para>Enter a command here to check before starting the
launcher. If the command is executable and is in your path, the launcher appears
on the panel.</para></entry></row>
<row><entry valign="top"><para><guilabel>Documentation</guilabel></para></entry>
<entry valign="top"><para>This field is not currently in use. </para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem><para>You can also add a translation of the <guilabel>Name</guilabel>, <guilabel>
Generic name</guilabel>, and <guilabel>Comment</guilabel> fields from the <guilabel>
Basic</guilabel> tabbed section. To add a translation, enter the details of
the translation in the <guilabel>Name/Comment translations</guilabel> table
as follows: </para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="20.78*"/>
<colspec colname="COLSPEC1" colwidth="79.22*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Field</para></entry><entry valign="top"><para>
Description </para></entry></row>
</thead>
<tbody>
<row><entry valign="top"><para>First field</para></entry><entry valign="top"><para>
Enter the two-letter code for the language for which you want to add a translation.
</para></entry></row>
<row><entry valign="top"><para>Second field</para></entry><entry valign="top"><para>
Enter the translation of the <guilabel>Name</guilabel> of the launcher.</para></entry>
</row>
<row><entry colname="COLSPEC0"><para>Third field</para></entry><entry colname="COLSPEC1"><para>
Enter the translation of the <guilabel>Generic name</guilabel> of the launcher.
</para></entry></row>
<row><entry valign="top"><para>Fourth field</para></entry><entry valign="top"><para>
Enter the translation for the <guilabel>Comment</guilabel> for the launcher. 
</para></entry></row>
</tbody>
</tgroup>
</informaltable>
<para>Then click on the <guibutton>Add/Set</guibutton> button. </para>
<para>To edit a translation, select the translation. The translated text appears
in the lower part of this dialog. Edit the fields as required, then click
on the <guibutton>Add/Set</guibutton> button.</para>
<para>To remove a translation, select the translation, then click on the <guibutton>
Remove</guibutton> button.</para></listitem>
<listitem><para>To create the launcher and close the <guilabel>Launcher Properties
</guilabel> dialog, click <guibutton>OK</guibutton>.</para></listitem>
</orderedlist>
</sect3>
</sect2>
<sect2 id="gospanel-36">
<title>To Modify the Properties of a Launcher</title>
<indexterm><primary>launchers</primary><secondary>modifying properties</secondary>
</indexterm><para>To modify the properties of a launcher perform the following
steps: </para>
<orderedlist>
<listitem><para>Right-click on the launcher to open the panel object popup
menu.</para></listitem>
<listitem><para>Choose <guimenuitem>Properties</guimenuitem>. Use the <guilabel>
Launcher Properties</guilabel> dialog to modify the properties as required.
For more information on the <guilabel>Launcher Properties</guilabel> dialog,
see <xref linkend="gospanel-52"/>. </para></listitem>
<listitem><para>Click <guibutton>Close</guibutton> to close the <guilabel>
Launcher Properties</guilabel> dialog.</para></listitem>
</orderedlist>
</sect2>
</sect1>
<sect1 id="gospanel-37">
<title>Menus</title>
<indexterm><primary>menus</primary><secondary>adding to panel</secondary>
</indexterm><indexterm><primary>panel objects</primary><secondary>menus</secondary>
</indexterm><para>You can add the following types of menu to your panels: 
</para>
<itemizedlist>
<listitem><para>System menus: System menus contain the standard applications
and tools that you can use on your desktop. The <guimenu>Applications</guimenu>
menu and <guimenu>Actions</guimenu> menu are system menus. To add a system
menu to a panel, right-click on a launcher in the menu, then choose <menuchoice>
<guimenu>Entire menu</guimenu><guimenuitem>Add this as menu to panel
</guimenuitem></menuchoice>. </para></listitem>
<listitem><para><guimenu>GNOME Menu</guimenu>: You can access almost all of
the standard applications, commands, and configuration options from the <guimenu>
GNOME Menu</guimenu>. To add a <guimenu>GNOME Menu</guimenu> to a panel, right-click
on any vacant space on the panel, then choose <menuchoice><guimenu>Add to
Panel</guimenu><guimenuitem>GNOME Menu</guimenuitem></menuchoice>.
You can add as many <guimenu>GNOME Menu</guimenu> objects to your panels as
you want. By default, the <guimenu>GNOME Menu</guimenu> is represented on
panels by a stylized footprint icon, as follows:</para>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/footprint_icon.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows GNOME Menu icon.</phrase>
  </textobject>
</mediaobject>
</screenshot>
</listitem>
</itemizedlist>
<para>Menus that you add to your panels are represented by an icon with an
arrow. The arrow indicates that the icon represents a menu or drawer. <xref
linkend="gospanel-FIG-68"/> shows how menus typically appear on panels. </para>
<figure id="gospanel-FIG-68">
<title>Typical Menu Objects on a Panel </title>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/typical_menu.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows typical menu objects on panel.</phrase>
  </textobject>
</mediaobject>
</screenshot>
</figure>
</sect1>
<sect1 id="gospanel-18">
<title>Drawers</title>
<indexterm><primary>panel objects</primary><secondary>drawers</secondary>
<see>drawers</see></indexterm><para>A drawer is an extension of a panel. You
can open and close a drawer in the same way that you can show and hide a panel.
A drawer can contain all panel objects, including launchers, menus, applets,
other panel objects, and other drawers. When you open a drawer, you can use
the objects in the same way that you use objects on a panel. </para>
<para>The following figure shows an open drawer that contains two panel objects. 
</para>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/open_drawer.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows an open drawer. The context describes the graphic.
</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para>The arrow on the drawer icon indicates that the icon represents a drawer
or menu.</para>
<para>You can add, move, and remove objects from drawers in the same way that
you add, move, and remove objects from panels. </para>
<sect2 id="gospanel-42">
<title>To Open and Close a Drawer</title>
<indexterm><primary>drawers</primary><secondary>opening</secondary></indexterm>
<indexterm><primary>drawers</primary><secondary>closing</secondary></indexterm>
<para>To open a drawer, click on the drawer object in a panel. You can close
a drawer in the following ways: </para>
<itemizedlist>
<listitem><para>Click on the drawer.</para></listitem>
<listitem><para>Click on the drawer hide button.</para></listitem>
</itemizedlist>
</sect2>
<sect2 id="gospanel-420">
<title>To Add a Drawer to a Panel</title>
<indexterm><primary>drawers</primary><secondary>adding to panel</secondary>
</indexterm><para>You can add a drawer to a panel in the following ways: 
</para>
<itemizedlist>
<listitem><para>From the panel popup menu</para>
<para>Right-click on any vacant space on the panel, then choose <menuchoice>
<guimenu>Add to Panel</guimenu><guimenuitem>Drawer</guimenuitem></menuchoice>. 
</para></listitem>
<listitem><para>From any menu</para>
<para>You can add a menu as a drawer object to a panel.</para>
<para>To add a menu as a drawer to a panel, open the menu from the panel.
Right-click on any launcher in the menu, then choose <menuchoice><guimenu>
Entire menu</guimenu><guimenuitem>Add this as drawer to panel</guimenuitem>
</menuchoice>.</para></listitem>
</itemizedlist>
</sect2>
<sect2 id="gospanel-54">
<title>To Add an Object to a Drawer</title>
<indexterm><primary>drawers</primary><secondary>adding objects to</secondary>
</indexterm><para>You add an object to a drawer in the same way that you add
objects to panels. For more information, see <xref linkend="gospanel-15"/>.
</para>
</sect2>
<sect2 id="gospanel-550">
<title>To Modify Drawer Properties</title>
<indexterm><primary>drawers</primary><secondary>modifying properties</secondary>
</indexterm><para>To modify preferences for all panels and drawers, choose <menuchoice>
<guimenu>Applications</guimenu><guisubmenu>Desktop Preferences
</guisubmenu><guisubmenu>Advanced</guisubmenu><guimenuitem>Panel</guimenuitem>
</menuchoice>, then make the changes that you require. For example, you can
select various options related to the appearance and behavior of objects on
panels and drawers. You can also select options that relate to drawers only.
For example, you can select an option to close your drawers when you click
on a launcher in the drawer.</para>
<para>You can also modify other properties for each individual drawer. You
can change features for each drawer, such as the visual appearance of the
drawer and whether the drawer has hide buttons.</para>
<para>To modify properties for a drawer perform the following steps: </para>
<orderedlist>
<listitem><para>Right-click on the drawer, then choose <guimenuitem>Properties
</guimenuitem> to display the <guilabel>Panel Properties</guilabel> dialog.
The dialog displays the <guilabel>Drawer</guilabel> tabbed section.</para></listitem>
<listitem><para>Select the properties for the drawer in the dialog. The following
table describes the elements on the <guilabel>Drawer</guilabel> tabbed section: 
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC2" colwidth="29.44*"/>
<colspec colname="COLSPEC3" colwidth="70.56*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Dialog Element</para></entry><entry
valign="top"><para>Description </para></entry></row>
</thead>
<tbody>
<row><entry colname="COLSPEC2" valign="top"><para><guilabel>Size</guilabel></para></entry>
<entry colname="COLSPEC3" valign="top"><para>Select the size of the drawer.
</para></entry></row>
<row><entry valign="top"><para><guilabel>Tooltip/Name</guilabel></para></entry>
<entry valign="top"><para>Use this text box to specify a name for the drawer.
The name appears as a tooltip when you point at the drawer on the panel.</para></entry>
</row>
<row><entry valign="top"><para><guilabel>Icon</guilabel></para></entry><entry
valign="top"><para>Choose an icon to represent the drawer. Click on the <guibutton>
Icon</guibutton> button to display an icon selector dialog. Choose an icon
from the dialog. Alternatively, click <guibutton>Browse</guibutton> to choose
an icon from another directory. When you choose an icon, click <guibutton>
OK</guibutton>. </para></entry></row>
<row><entry valign="top"><para><guilabel>Enable hide button</guilabel></para></entry>
<entry valign="top"><para>Select this option to display a hide button when
the drawer opens. </para></entry></row>
<row><entry valign="top"><para><guilabel>Enable hide button arrow</guilabel></para></entry>
<entry valign="top"><para>Select this option to display an arrow on the hide
button if the hide button is enabled.</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem><para>You can use the <guilabel>Background</guilabel> tabbed section
to set the background for the drawer. For information on how to complete the <guilabel>
Background</guilabel> tabbed section, see the step on this topic in <xref
linkend="gospanel-28"/>. You can also drag a color or image on to a drawer
to set the color or image as the background of the drawer. For more information,
 see <xref linkend="gospanel-61"/>.</para></listitem>
<listitem><para>Click <guibutton>Close</guibutton> to close the <guilabel>
Panel Properties</guilabel> dialog.</para></listitem>
</orderedlist>
</sect2>
</sect1>
<sect1 id="gospanel-20">
<title>Log Out Button</title>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/logout_icon.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows Log Out icon.</phrase>
  </textobject>
</mediaobject>
</screenshot>
<indexterm><primary>panel objects</primary><secondary>Log Out button</secondary>
</indexterm><indexterm><primary>Log Out button</primary></indexterm><para>
The <guibutton>Log Out</guibutton> button begins the process to log out of
a GNOME session. </para>
<para>To add a <guibutton>Log Out</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel
</guimenu><guimenuitem>Log Out Button</guimenuitem></menuchoice>. To log out
of your session or shut down your system, click on the <guibutton>Log Out
</guibutton> button. </para>
</sect1>
<sect1 id="gospanel-21">
<title>Lock Button</title>
<screenshot>
<mediaobject>
  <imageobject>
    <imagedata fileref="figures/lockscreen_icon.png" format="PNG"/>
  </imageobject>
  <textobject>
	<phrase>Shows Lock icon.</phrase>
  </textobject>
</mediaobject>
</screenshot>
<indexterm><primary>panel objects</primary><secondary>Lock button</secondary>
</indexterm><indexterm><primary>Lock button</primary></indexterm><indexterm>
<primary>locking screen</primary></indexterm><para>The <guibutton>Lock</guibutton>
button locks your screen and activates your screensaver. To access your session
again, you must enter your password. To lock your screen correctly, you must
have a screensaver enabled.</para>
<para>To add a <guibutton>Lock</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel
</guimenu><guimenuitem>Lock Button</guimenuitem></menuchoice>. </para>
<para>Right-click on the <guibutton>Lock</guibutton> button to open a menu
of screensaver-related commands. <xref linkend="gosstartsession-TBL-83"/> describes
the commands that are available from the menu.</para>
<table frame="topbot" id="gosstartsession-TBL-83">
<title>Lock Screen Menu Items</title>
<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="43.55*"/>
<colspec colname="COLSPEC1" colwidth="56.45*"/>
<thead>
<row rowsep="1"><entry valign="top"><para>Menu Item</para></entry><entry valign="top"><para>
Function</para></entry></row>
</thead>
<tbody>
<row><entry valign="top"><para><guimenuitem>Activate Screensaver</guimenuitem></para></entry>
<entry valign="top"><para>Activates the screensaver immediately, but does
not lock the screen.</para></entry></row>
<row><entry valign="top"><para><guimenuitem>Lock Screen</guimenuitem></para></entry>
<entry valign="top"><para>Locks the screen immediately. This command performs
the same function as when you click on the <guibutton>Lock</guibutton> button.
</para></entry></row>
<row><entry valign="top"><para><guimenuitem>Kill Screensaver Daemon</guimenuitem></para></entry>
<entry valign="top"><para>Terminates the screensaver process. After you terminate
the screensaver process, you cannot lock your screen.</para></entry></row>
<row><entry valign="top"><para><guimenuitem>Restart Screensaver Daemon</guimenuitem></para></entry>
<entry valign="top"><para>Terminates and restarts the screensaver process.
Use this command after you change your password. When you restart the screensaver
process, use your new password with the screensaver.</para></entry></row>
<row><entry valign="top"><para><guimenuitem>Properties</guimenuitem></para></entry>
<entry valign="top"><para>Displays an <guilabel>XScreenSaver</guilabel> dialog
that you can use to configure the screensaver. </para></entry></row>
</tbody>
</tgroup>
</table>
</sect1>
</chapter>