1 .\" Copyright (c) 2014-2016 Bert Burgemeister <trebbu@googlemail.com>
3 .\" Permission is hereby granted, free of charge, to any person obtaining
4 .\" a copy of this software and associated documentation files (the
5 .\" "Software"), to deal in the Software without restriction, including
6 .\" without limitation the rights to use, copy, modify, merge, publish,
7 .\" distribute, sublicense, and/or sell copies of the Software, and to
8 .\" permit persons to whom the Software is furnished to do so, subject to
9 .\" the following conditions:
11 .\" The above copyright notice and this permission notice shall be
12 .\" included in all copies or substantial portions of the Software.
14 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15 .\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17 .\" NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18 .\" LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19 .\" OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20 .\" WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27 .Nd pipe-driven GTK+ interface
34 .Op Fl u Ar builder-file
35 .Op Fl e Ar parent-xid
38 .Op Fl -display Ar X-server
43 is a helper program that displays graphical user
44 interfaces for other programs.
45 It renders the GUI definition found in a GtkBuilder XML file
46 (typically created using the
48 interface designer), and communicates with the main program solely
49 through plain text messages via pipes or fifos.
50 It provides access to a subset of features of a subset of widgets of
52 Simple one-shot dialogs as well as more complex, long-running programs
62 if necessary, sets its permissions to
64 and uses it for command input.
66 A command is a line of text.
68 .Qq Ar id Ns Cm \&: Ns Ar action Bq Ar data ,
70 being the name of the receiving widget;
72 is separated from the rest of the command by a single whitespace
74 Commands whose first non-whitespace character is
76 are considered comments and ignored silently, as are empty input lines.
77 Any occurences of the two-character sequences
81 will be converted into newline or carriage return, respectively.
82 Every other character following a backslash will be left unchanged,
83 but the backslash will be removed.
84 Invalid commands are reported on
86 and are otherwise ignored.
89 for applicable commands.
93 exists but is not a named pipe.
96 is deleted upon successful program termination.
98 Default command input is
103 if necessary, sets its permissions to
105 and uses it for output of feedback messages from the
106 graphical user interface.
108 A feedback message is a line of text; its format is
109 .Qq Ar id Ns Cm \&: Ns Ar info Bq Ar data ,
111 being the name of the sending widget.
114 for possible feedback messages.
118 exists but is not a named pipe.
121 is deleted upon successful program termination.
123 Default feedback-message output is
128 in the background after printing its process ID to
131 It is an error if option
138 .It Fl u Ar builder-file
139 Displays the graphical user interface
141 which should be created using the
143 user interface designer and saved in GtkBuilder (.ui) format.
144 Widget ids should consist of alphanumeric ASCII characters including
145 hyphens and underscores.
146 The main window must must be given the id
151 .It Fl e Ar parent-xid
152 Embeds the main window into the XEmbed socket
156 Appends for each command a line of
161 being the number of microseconds elapsed during
166 are separated by a tab character.
180 appending its output to
186 .It Fl -display Ar X-server
189 for user interaction.
191 Prints a help message and exits.
193 Prints the versions of the underlying GTK+ and cairo libraries and
201 The widget classes able to communicate through
211 .Sx GtkComboBoxText ,
217 .Sx GtkFileChooserButton ,
218 .Sx GtkFileChooserDialog ,
223 .Sx GtkImageMenuItem ,
230 .Sx GtkPrintUnixDialog ,
234 .Sx GtkScrolledWindow ,
236 .Sx GtkSeparatorMenuItem ,
243 .Sx GtkToggleButton ,
245 .Sx GtkTreeViewColumn ,
252 references a widget by the
254 attribute it is given in Glade.
262 .Dl <object class="GtkWindow" id="foo"> .
264 .\" Commands most widgets understand:
276 .Ss Unspecific Widget
277 .Bl -tag -width "commands "
280 .Qq Ar id Ns Cm :load Ar file
287 is required but ignored.
289 commands may be nested but on attempts to read from the same file, the
300 .Qq Ar id Ns Cm :main_quit
301 kills the user interface.
304 is required but ignored.
307 .Bl -tag -width "commands "
309 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
310 makes the box grayed out
315 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
318 the box, or makes it visible
320 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
321 sets the box's tooltip.
322 Default is disabling the tooltip.
324 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
325 writes a snapshot of the box to an image file of the specified
328 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
329 sets the box's minimum size to
333 Default is the box's natural size.
337 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
346 .Bl -tag -width "commands "
348 .Qq Ar id Ns Cm :set_label Ar string
349 replaces the button text with
352 .Qq Ar id Ns Cm :grab_focus
353 puts the keyboard focus onto the button.
355 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
356 makes the button grayed out
361 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
364 the widget, or makes it visible
367 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
373 Initially, the button is unblocked.
375 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
376 sets the button's tooltip.
377 Default is disabling the tooltip.
379 .Qq Ar id Ns Cm :force
380 simulates a click on the button.
382 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
383 writes a snapshot of the button to an image file of the specified
386 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
387 sets the button's minimum size to
391 Default is the button's natural size.
395 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
401 .Qq Ar id Ns Cm \&:clicked
405 .Cm _ok , _apply , _cancel , _send_text ,
408 may work differently; see
409 .Sx GtkDialog , GtkFileChooserDialog ,
415 .Bl -tag -width "commands "
417 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
418 makes the box grayed out
423 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
426 the box, or makes it visible
429 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
430 sets the box's tooltip.
431 Default is disabling the tooltip.
433 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
434 writes a snapshot of the box to an image file of the specified
437 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
438 sets the box's minimum size to
442 Default is the box's natural size.
446 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
455 .Bl -tag -width "commands "
457 .Qq Ar id Ns Cm :select_date Ar yyyy Ns Cm - Ns Ar mm Ns Cm - Ns Ar dd
458 selects the date on the calendar.
460 .Qq Ar id Ns Cm :mark_day Ar day
465 .Qq Ar id Ns Cm :clear_marks
466 unmarks all days on the calendar.
468 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
469 makes the calendar grayed out
474 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
477 the calendar, or makes it visible
480 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
486 Initially, the calendar is unblocked.
488 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
489 sets the calendar's tooltip.
490 Default is disabling the tooltip.
492 .Qq Ar id Ns Cm :force
493 simulates a click on the currently selected date.
495 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
496 writes a snapshot of the calendar to an image file of the specified
499 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
500 sets the calendar's minimum size to
504 Default is the widget's natural size.
508 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
510 sets the calendar's style.
514 .Qq Ar id Ns Cm \&:clicked Ar yyyy Ns Cm - Ns Ar mm Ns Cm - Ns Ar dd
516 .Qq Ar id Ns Cm \&:doubleclicked Ar yyyy Ns Cm - Ns Ar mm Ns Cm - Ns Ar dd
519 .Bl -tag -width "commands "
521 .Qq Ar id Ns Cm :set_active Brq Cm 0 Ns | Ns Cm 1
522 switches the check mark off
527 .Qq Ar id Ns Cm :set_label Ar string
528 replaces the button text with
531 .Qq Ar id Ns Cm :grab_focus
532 puts the keyboard focus onto the button.
534 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
535 makes the button grayed out
540 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
543 the button, or makes it visible
546 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
552 Initially, the button is unblocked.
554 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
555 sets the button's tooltip.
556 Default is disabling the tooltip.
558 .Qq Ar id Ns Cm :force
559 simulates a click on the button.
561 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
562 writes a snapshot of the button to an image file of the specified
565 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
566 sets the button's minimum size to
570 Default is the widget's natural size.
574 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
576 sets the button's style.
586 .Bl -tag -width "commands "
588 .Qq Ar id Ns Cm :set_color Ar color
589 preselects the color; see
592 .Qq Ar id Ns Cm :grab_focus
593 puts the keyboard focus onto the button.
595 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
596 makes the button grayed out
601 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
604 the button, or makes it visible
607 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
613 Initially, the button is unblocked.
615 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
616 sets the button's tooltip.
617 Default is disabling the tooltip.
619 .Qq Ar id Ns Cm :force
620 opens the dialog window.
622 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
623 writes a snapshot of the button to an image file of the specified
626 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
627 sets the button's minimum size to
631 Default is the widget's natural size.
635 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
637 sets the button's style.
641 .Qq Ar id Ns Cm \&:color Cm rgb( Ns Ar red Ns Cm \&, Ns Ar green Ns Cm \&, Ns Ar blue Ns Cm \&)
643 .Qq Ar id Ns Cm \&:color Cm rgba( Ns Ar red Ns Cm \&, Ns Ar green Ns Cm \&, Ns Ar blue Ns Cm \&, Ns Ar alpha Ns Cm \&) .
647 lie between 0 and 255, and
656 .Bl -tag -width "commands "
658 .Qq Ar id Ns Cm :prepend_text Ar string
660 .Qq Ar id Ns Cm :append_text Ar string
661 prepend/append a new selectable item marked
664 .Qq Ar id Ns Cm :insert_text Ar position string
670 .Qq Ar id Ns Cm :remove Ar position
674 .Qq Ar id Ns Cm :grab_focus
675 puts the keyboard focus onto the combo box.
677 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
678 makes the combo box grayed out
683 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
686 the combo box, or makes it visible
689 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
695 Initially, the combo box is unblocked.
697 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
699 Default is disabling the tooltip.
701 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
702 writes a snapshot of the combo box to an image file of the specified
705 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
706 sets the combo box's minimum size to
710 Default is the natural size.
714 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
720 .Qq Ar entry_id Ns Cm \&:text Ar text ,
722 being the id of the child
735 .Ar foo Ns Cm _invoke .
743 .Ar foo Ns Cm _cancel
745 if the dialog is the sole window of the GUI and therefore named
756 it will take care of hiding the dialog window.
757 .Bl -tag -width "commands "
759 .Qq Ar id Ns Cm :set_title Ar string
760 replaces the text in the title bar with
763 .Qq Ar id Ns Cm :resize Bq Ar width height
764 changes the size of the dialog window to
768 pixels if specified, or to the default size.
770 .Qq Ar id Ns Cm :move Ar x y
771 moves the dialog window to position
774 .Qq Ar id Ns Cm :fullscreen
776 .Qq Ar id Ns Cm :unfullscreen
777 switch fullscreen mode on and off.
779 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
780 makes the dialog grayed out
785 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
788 the dialog, or makes it visible
791 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
796 feedback messages from the dialog window.
797 Initially, the window is unblocked.
799 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
800 sets the dialog window's tooltip.
801 Default is disabling the tooltip.
803 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
804 writes a snapshot of the dialog window to an image file of the
807 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
808 sets the dialog window's minimum size to
812 Default is its natural size.
816 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
818 sets the dialog window's style.
822 .Qq Ar id Ns Cm \&:closed
825 window was closed by the window manager.
829 expect a context parameter of the form
830 .Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
833 is an arbitrary non-negative integer that can be used later to
834 reference the command.
837 appends its command to the current list of drawing operations.
840 replaces the first drawing operation with context parameter
844 .Ar n Ns Cm < Ns Ar m ,
845 inserts its command before the first drawing operation with context
848 Both second and third form fall back to appending.
850 The default coordinate system is a left-handed system with its origin
851 in the upper-left corner.
852 Angles increase from the positive X axis towards the positve Y axis
853 .Pq clockwise in the default system .
854 .Bl -tag -width "commands "
856 .Qq Ar id Ns Cm :arc Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc x y radius angle1 angle2
857 adds a circular arc to the current path.
858 The arc is centered at
866 .Qq Ar id Ns Cm :arc_negative Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc x y radius angle1 angle2
867 adds a circular arc to the current path.
868 The arc is centered at
870 and proceeds in the direction of decreasing angles from
876 .Qq Ar id Ns Cm :close_path Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
877 adds a line segment from the current point to the point most recently
879 .Ar id Ns Cm :move_to
881 .Ar id Ns Cm :rel_move_to .
883 .Qq Ar id Ns Cm :curve_to Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc x1 y1 x2 y2 x3 y3
884 adds a cubic Bezier spline from the current point to
891 If there is no current point, the curve will start at
894 .Qq Ar id Ns Cm :fill Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
895 fills the current path and clears it.
897 .Qq Ar id Ns Cm :fill_preserve Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
898 fills the current path without clearing it.
900 .Qq Ar id Ns Cm :line_to Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc x y
901 adds a line from the current point to
903 or creates a new current point at
906 .Qq Ar id Ns Cm :move_to Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc x y
907 sets the current point to
910 .Qq Ar id Ns Cm :rectangle Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc x y width height
911 adds a rectangle to the current path.
912 The top left corner is at
915 .Qq Ar id Ns Cm :rel_curve_to Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc dx1 dy1 dx2 dy2 dx3 dy3
916 adds a cubic Bezier spline from the current point to
923 All coordinates are offsets relative to the current point.
925 .Qq Ar id Ns Cm :rel_line_to Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc dx dy
926 adds a line from the current point to a point offset from there by
929 .Qo Ar id Ns Cm :rel_move_for Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
930 .Brq Cm c Ns | Ns Cm e Ns | Ns Cm n Ns | Ns Cm ne Ns | Ns Cm nw Ns | Ns Cm s Ns | Ns Cm se Ns | Ns Cm sw Ns | Ns Cm w
933 moves the current point such that
934 .Qq Ar id Ns Cm :show_text Ar n text
935 will place the specified reference point of
937 on the original current point.
939 .Qq Ar id Ns Cm :rel_move_to Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc dx dy
940 moves the current point by
943 .Qq Ar id Ns Cm :remove Ar n
944 removes the elements with context parameter
947 .Cm GtkDrawingArea Ar id .
949 .Qq Ar id Ns Cm :rotate Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc Ar angle
950 rotates the user space axes by
954 .Qq Ar id Ns Cm :scale Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc Ar sx sy
955 scales the user space axes by
958 .Qq Ar id Ns Cm :set_dash Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc l
959 sets the dash pattern to
965 .Qq Ar id Ns Cm :set_dash Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc l1on l1off l2on l2off ...
966 resets the dash pattern to a line with arbitrary on/off portions.
968 .Qq Ar id Ns Cm :set_dash Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
969 resets the dash pattern to a solid line.
971 .Qo Ar id Ns Cm :set_font_face Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
972 .Brq Cm normal | italic | oblique
973 .Brq Cm normal | bold
976 sets the font face for subsequent calls of
977 .Ar id Ns Cm :show_text .
979 .Qq Ar id Ns Cm :set_font_size Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc size
980 sets the font size for subsequent calls of
981 .Ar id Ns Cm :show_text .
983 .Qq Ar id Ns Cm :set_line_cap Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc Brq Cm butt | round | square
984 sets the line cap style.
988 .Qq Ar id Ns Cm :set_line_join Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc Brq Cm miter | round | bevel
989 sets the line junction style.
993 .Qq Ar id Ns Cm :set_line_width Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc width
999 .Qq Ar id Ns Cm :set_source_rgba Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc color
1003 .Qq Ar id Ns Cm :show_text Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc text
1006 beginning at the current point.
1008 .Qq Ar id Ns Cm :stroke Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
1009 strokes the current path and clears it.
1011 .Qq Ar id Ns Cm :stroke_preserve Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc
1012 strokes the current path without clearing it.
1014 .Qq Ar id Ns Cm :transform Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc Bq Ar xx yx xy yy x0 y0
1015 modifies the current transformation matrix such that
1017 .Dl Va x' Li = Ar xx Va x Li + Ar xy Va y Li + Ar x0 ,
1018 .Dl Va y' Li = Ar yx Va y Li + Ar yy Va y Li + Ar y0 .
1020 Default is resetting the current transformation matrix.
1022 .Qq Ar id Ns Cm :translate Bro Ar n Ns | Ns Cm = Ns Ar n Ns | Ns Ar n Ns Cm < Ns Ar m Brc Ar tx ty
1023 translates the user space origin by
1026 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1029 the drawing area, or makes it visible
1032 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1033 sets the drawing area's tooltip.
1034 Default is disabling the tooltip.
1036 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1037 writes a snapshot of the drawing area to an image file of the specified
1040 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1041 sets the drawing areas's minimum size to
1045 Default is the natural size.
1050 .Bl -tag -width "commands "
1052 .Qq Ar id Ns Cm :set_text Ar string
1053 replaces the user-editable text with
1056 .Qq Ar id Ns Cm :set_placeholder_text Ar string
1059 that is displayed when the entry is empty and unfocused.
1061 .Qq Ar id Ns Cm :grab_focus
1062 puts the keyboard focus into the entry.
1064 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1065 makes the entry grayed out
1070 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1073 the entry, or makes it visible
1076 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1082 Initially, the entry is unblocked.
1084 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1085 sets the entry's tooltip.
1086 Default is disabling the tooltip.
1088 .Qq Ar id Ns Cm :force
1089 lets the entry report its current content.
1091 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1092 writes a snapshot of the entry to an image file of the specified
1095 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1096 sets the entry's minimum size to
1100 Default is the entry's natural size.
1104 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1110 .Qq Ar id Ns Cm \&:text Ar text ,
1111 once for each change of
1116 are mouse pointer coordinates relative to the
1118 .Bl -tag -width "commands "
1120 .Qq Ar id Ns Cm :grab_focus
1121 puts the keyboard focus onto the event box.
1123 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1124 makes the event box insensitive
1129 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1135 Initially, the event box is unblocked.
1137 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1138 sets the tooltip of the event box.
1139 Default is disabling the tooltip.
1141 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1142 writes a snapshot of the event box to an image file of the specified
1145 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1146 sets the minimum size to
1150 Default is the natural size of the event box.
1154 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1156 sets the widget style.
1160 .Qq Ar id Ns Cm \&:button_press Ar b x y ,
1161 .Qq Ar id Ns Cm \&:button_release Ar b x y
1164 is the mouse button (normally 1, 2, or 3 for the left, middle, and
1165 right button; others may exist).
1167 .Qq Ar id Ns Cm \&:motion Ar x y
1168 is reported repeatedly while the mouse is being moved with a button
1171 .Qq Ar id Ns Cm \&:key_press Ar key ,
1173 being the key's name
1181 .Bl -tag -width "commands "
1183 .Qq Ar id Ns Cm :set_label Ar string
1184 replaces the expander label text with
1187 .Qq Ar id Ns Cm :set_expanded Brq Cm 0 Ns | Ns 1
1190 the child widget, or makes it visible
1193 .Qq Ar id Ns Cm :grab_focus
1194 puts the keyboard focus onto the expander.
1196 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1197 makes the expander grayed out
1202 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1205 the expander, or makes it visible
1208 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1209 sets the expander's tooltip.
1210 Default is disabling the tooltip.
1212 .Qq Ar id Ns Cm :force
1213 toggles the expansion state.
1215 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1216 writes a snapshot of the expander to an image file of the specified
1219 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1220 sets the expander's minimum size to
1224 Default is the natural size.
1228 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1237 .Bl -tag -width "commands "
1239 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1242 the grid, or makes it visible
1244 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1245 sets the grid's tooltip.
1246 Default is disabling the tooltip.
1248 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1249 writes a snapshot of the grid to an image file of the specified
1252 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1253 sets the grid's minimum size to
1257 Default is the grid's natural size.
1261 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1269 .Ss GtkFileChooserButton
1270 .Bl -tag -width "commands "
1272 .Qq Ar id Ns Cm :set_filename Ar path
1275 to the extent it exists.
1277 .Qq Ar id Ns Cm :grab_focus
1278 puts the keyboard focus onto the button.
1280 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1281 makes the button grayed out
1286 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1289 the button, or makes it visible
1292 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1298 Initially, the button is unblocked.
1300 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1301 sets the button's tooltip.
1302 Default is disabling the tooltip.
1304 .Qq Ar id Ns Cm :force
1305 simulates fresh selection of the currently selected pathname.
1307 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1308 writes a snapshot of the button to an image file of the specified
1311 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1312 sets the button's minimum size to
1316 Default is the widget's natural size.
1320 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1326 .Qq Ar id Ns Cm \&:file Ar pathname
1327 if the selection has changed.
1329 .Ss GtkFileChooserDialog
1331 .Cm GtkFileChooserDialog
1334 will be invoked by a
1337 .Sx GtkImageMenuItem
1339 .Ar foo Ns Cm _invoke .
1342 .Cm GtkFileChooserDialog
1349 if the dialog is the sole window of the GUI and therefore named
1354 .Cm GtkFileChooserDialog
1359 .Ar foo Ns Cm _cancel
1361 if the dialog is the sole window of the GUI and therefore named
1366 .Cm GtkFileChooserDialog
1371 .Ar foo Ns Cm _apply
1373 if the dialog is the sole window of the GUI and therefore named
1376 .Bl -tag -width "commands "
1378 .Qq Ar id Ns Cm :set_filename Ar path
1381 to the extent it exists.
1383 .Qq Ar id Ns Cm :set_current_name Ar string
1386 the suggested filename, which may not yet exist.
1388 should either resemble an absolute path, or the
1390 must be set separately by
1391 .Ar id Ns Cm :set_filename Ar directory .
1393 .Qq Ar id Ns Cm :set_title Ar string
1394 replaces the text in the title bar with
1397 .Qq Ar id Ns Cm :resize Bq Ar width height
1398 changes the size of the dialog window to
1402 pixels if specified, or to the default size.
1404 .Qq Ar id Ns Cm :move Ar x y
1405 moves the dialog window to position
1408 .Qq Ar id Ns Cm :fullscreen
1410 .Qq Ar id Ns Cm :unfullscreen
1411 switch fullscreen mode on and off.
1413 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1414 makes the dialog grayed out
1419 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1422 the dialog, or makes it visible
1425 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1430 feedback messages form the dialog window.
1431 Initially, the widget is unblocked.
1433 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1434 sets the dialog window's tooltip.
1435 Default is disabling the tooltip.
1437 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1438 writes a snapshot of the widget to an image file of the specified
1441 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1442 sets the widget's minimum size to
1446 Default is the widget's natural size.
1450 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1452 sets the widget style.
1456 .Qq Ar id Ns Cm \&:file Ar pathname
1458 .Qq Ar id Ns Cm \&:folder Ar pathname
1460 .Qq Ar id Ns Cm \&:closed
1462 .Cm GtkFileChooserDialog
1463 window was closed by the window manager.
1466 .Bl -tag -width "commands "
1468 .Qq Ar id Ns Cm :set_font_name Ar fontname
1469 preselects the font.
1471 .Qq Ar id Ns Cm :grab_focus
1472 puts the keyboard focus onto the button.
1474 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1475 makes the button grayed out
1480 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1483 the button, or makes it visible
1486 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1492 Initially, the button is unblocked.
1494 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1495 sets the button's tooltip.
1496 Default is disabling the tooltip.
1498 .Qq Ar id Ns Cm :force
1499 opens the dialog window.
1501 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1502 writes a snapshot of the button to an image file of the specified
1505 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1506 sets the button's minimum size to
1510 Default is the button's natural size.
1514 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1520 .Qq Ar id Ns Cm \&:font Ar fontname
1523 .Bl -tag -width "commands "
1525 .Qq Ar id Ns Cm :set_label Ar text
1526 replaces the frame label text with
1529 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1530 makes the frame and its content grayed out
1535 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1538 the frame, or makes it visible
1541 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1542 sets the frame's tooltip.
1543 Default is disabling the tooltip.
1545 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1546 writes a snapshot of the frame to an image file of the specified
1549 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1550 sets the widget's minimum size to
1554 Default is the frame's natural size.
1558 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1567 .Bl -tag -width "commands "
1569 .Qq Ar id Ns Cm :set_from_icon_name Ar icon-name
1570 replaces the image with one of the standard icons.
1572 .Qq Ar id Ns Cm :set_from_file Ar path
1573 replaces the image by the one found at
1576 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1579 the image, or makes it visible
1582 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1583 sets the image's tooltip.
1584 Default is disabling the tooltip.
1586 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1587 writes a snapshot of the image to an image file of the specified
1590 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1591 sets the images's minimum size to
1595 Default is the image's natural size.
1599 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1607 .Ss GtkImageMenuItem
1608 .Cm GtkImageMenuItem
1610 .Bl -tag -width "commands "
1612 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1613 makes the item grayed out
1618 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1621 the item, or makes it visible
1624 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1630 Initially, the item is unblocked.
1632 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1633 sets the item's tooltip.
1634 Default is disabling the tooltip.
1636 .Qq Ar id Ns Cm :force
1637 simulates a click on the menu item.
1639 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1640 sets the item's minimum size to
1644 Default is the item's natural size.
1648 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1650 sets the item's style.
1655 .Cm GtkImageMenuItem
1657 .Ar foo Ns Cm _invoke
1661 .Sx GtkFileChooserDialog
1665 If there isn't any dialog attached to the
1666 .Cm GtkImageMenuItem ,
1668 .Qq Ar id Ns Cm \&:active Ar label .
1671 .Bl -tag -width "commands "
1673 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1674 makes the info bar grayed out
1679 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1682 the info bar, or makes it visible
1685 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1686 sets the info bar's tooltip.
1687 Default is disabling the tooltip.
1689 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1690 sets the info bar's minimum size to
1694 Default is the info bar's natural size.
1698 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1707 .Bl -tag -width "commands "
1709 .Qq Ar id Ns Cm :set_text Ar string
1710 replaces the label text with
1713 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1714 makes the label grayed out
1719 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1722 the label, or makes it visible
1725 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1726 sets the label's tooltip.
1727 Default is disabling the tooltip.
1729 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1730 writes a snapshot of the label to an image file of the specified
1733 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1734 sets the label's minimum size to
1738 Default is the natural size.
1742 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1744 sets the label's style.
1751 .Bl -tag -width "commands "
1753 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1754 makes the item grayed out
1759 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1762 the item, or makes it visible
1765 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1771 Initially, the item is unblocked.
1773 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1774 sets the item's tooltip.
1775 Default is disabling the tooltip.
1777 .Qq Ar id Ns Cm :force
1778 simulates a click on the menu item.
1780 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1781 sets the item's minimum size to
1785 Default is the item's natural size.
1789 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1791 sets the item's style.
1798 .Ar foo Ns Cm _invoke
1802 .Sx GtkFileChooserDialog
1806 If there isn't any dialog attached to the
1809 .Qq Ar id Ns Cm \&:active Ar label .
1812 .Bl -tag -width "commands "
1814 .Qq Ar id Ns Cm :set_current_page Ar n
1815 switches to zero-based page number
1818 .Qq Ar id Ns Cm :grab_focus
1819 puts the keyboard focus onto the notebook.
1821 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1822 makes the notebook grayed out
1827 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1830 the notebook, or makes it visible
1833 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1834 sets the notebook's tooltip.
1835 Default is disabling the tooltip.
1837 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1838 writes a snapshot of the notebook to an image file of the specified
1841 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1842 sets the notebooks's minimum size to
1846 Default is the widget's natural size.
1850 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1852 sets the notebook's style.
1859 .Bl -tag -width "commands "
1861 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1862 makes the overlay grayed out
1867 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1870 the overlay, or makes it visible
1873 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1874 sets the overlay's tooltip.
1875 Default is disabling the tooltip.
1877 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1878 writes a snapshot of the overlay to an image file of the specified
1881 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1882 sets the overlay's minimum size to
1886 Default is the overlay's natural size.
1890 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1899 The main window can be turned into a
1901 and embedded into the XEmbed socket of another process; see
1905 .Ss GtkPrintUnixDialog
1906 .Bl -tag -width "commands "
1908 .Qq Ar id Ns Cm :print Ar file.ps
1909 opens the print dialog.
1914 to the printer the user selected in the dialog.
1916 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
1917 makes the dialog grayed out
1922 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1925 the dialog, or makes it visible
1928 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
1934 Initially, the dialog is unblocked.
1936 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1937 sets the dialog's tooltip.
1938 Default is disabling the tooltip.
1940 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1941 writes a snapshot of the dialog to an image file of the specified
1944 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1945 sets the dialog's minimum size to
1949 Default is the dialog's natural size.
1953 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
1955 sets the widget style.
1959 .Qq Ar id Ns Cm \&:closed
1961 .Cm GtkPrintUnixDialog
1962 window was closed by the window manager.
1965 .Bl -tag -width "commands "
1967 .Qq Ar id Ns Cm :set_fraction Ar x
1968 moves the progress bar to
1970 .Pq between 0 and 1 .
1972 .Qq Ar id Ns Cm :set_text Bq Ar string
1973 replaces the text of the progress bar with
1975 Default is the progress percentage.
1977 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
1980 the progress bar, or makes it visible
1983 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
1984 sets the tooltip of the progressbar.
1985 Default is disabling the tooltip.
1987 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
1988 writes a snapshot of the progress bar to an image file of the
1991 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
1992 sets the minimum size of the progress bar to
1996 Default is the natural size.
2000 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2009 .Bl -tag -width "commands "
2011 .Qq Ar id Ns Cm :set_active 1
2012 switches the button on.
2013 All other buttons of the same group will go off automatically.
2015 .Qq Ar id Ns Cm :set_label Ar string
2016 replaces the button text with
2019 .Qq Ar id Ns Cm :grab_focus
2020 puts the keyboard focus onto the button.
2022 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2023 makes the button grayed out
2028 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2031 the button, or makes it visible
2034 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
2040 Initially, the button is unblocked.
2042 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2043 sets the button's tooltip.
2044 Default is disabling the tooltip.
2046 .Qq Ar id Ns Cm :force
2047 simulates a click on the button.
2049 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2050 writes a snapshot of the button to an image file of the specified
2053 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2054 sets the button's minimum size to
2058 Default is the button's natural size.
2062 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2068 .Qq Ar id Ns Cm \&:1
2070 .Qq Ar id Ns Cm \&:0
2074 .Bl -tag -width "commands "
2076 .Qq Ar id Ns Cm :set_value Ar x
2077 moves the slider to value
2080 .Qq Ar id Ns Cm :set_fill_level Bq Ar x
2081 moves the fill level indicator to value
2083 Default is hiding the fill level indicator.
2085 .Qq Ar id Ns Cm :set_range Ar min max
2088 .Qq Ar id Ns Cm :set_increments Ar step page
2089 sets the steps the slider moves while pressing arrow keys and
2091 .Pf / Ql Page_Down ,
2094 .Qq Ar id Ns Cm :grab_focus
2095 puts the keyboard focus onto the scale.
2097 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2098 makes the scale grayed out
2103 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2106 the scale, or makes it visible
2109 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
2115 Initially, the scale is unblocked.
2117 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2118 sets the scale's tooltip.
2119 Default is disabling the tooltip.
2121 .Qq Ar id Ns Cm :force
2122 simulates fresh selection of the current value.
2124 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2125 writes a snapshot of the scale to an image file of the specified
2128 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2129 sets the scale's minimum size to
2133 Default is the natural size.
2137 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2143 .Qq Ar id Ns Cm \&:value Ar number
2145 .Ss GtkScrolledWindow
2146 .Bl -tag -width "commands "
2148 .Qq Ar id Ns Cm :hscroll Ar position
2150 .Qq Ar id Ns Cm :vscroll Ar position
2153 to the left or top edge of the
2154 .Cm GtkScrolledWindow ,
2157 .Qq Ar id Ns Cm :hscroll_to_range Ar pos0 pos1
2159 .Qq Ar id Ns Cm :vscroll_to_range Ar pos0 pos1
2160 scroll, if necessary, the range between
2165 .Cm GtkScrolledWindow .
2166 If the range is greater than the window, the initial part of the range
2169 .Qq Ar id Ns Cm :grab_focus
2170 puts the keyboard focus onto the widget.
2172 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2173 makes the widget grayed out
2178 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2181 the widget, or makes it visible
2184 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2185 sets the widget's tooltip.
2186 Default is disabling the tooltip.
2188 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2189 writes a snapshot of the widget to an image file of the specified
2192 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2193 sets the minimum size to
2197 Default is the widget's natural size.
2201 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2210 .Bl -tag -width "commands "
2212 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2213 makes the separator insensitive
2218 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2219 sets the tooltip of the separator.
2220 Default is disabling the tooltip.
2222 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2225 the separator, or makes it visible
2228 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2229 writes a snapshot of the separator to an image file of the specified
2232 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2233 sets the minimum size to
2237 Default is the natural size of the separator.
2241 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2243 sets the widget style.
2249 .Ss GtkSeparatorMenuItem
2250 .Bl -tag -width "commands "
2252 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2253 makes the menu item insensitive
2258 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2261 the menu item, or makes it visible
2264 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2265 sets the tooltip of the menu item.
2266 Default is disabling the tooltip.
2268 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2269 writes a snapshot of the menu item to an image file of the specified
2272 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2273 sets the minimum size to
2277 Default is the natural size of the menu item.
2281 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2283 sets the widget style.
2291 may be unsupported by Glade, but its definition can be inserted
2292 manually into the GtkBuilder
2295 .Bd -literal -offset indent
2297 <object class="GtkSocket" id="socket1">
2298 <property name="visible">True</property>
2299 <property name="can_focus">True</property>
2302 <property name="expand">True</property>
2303 <property name="fill">True</property>
2304 <property name="position">1</property>
2308 .Bl -tag -width "commands "
2311 requests a feedback message containing the socket
2314 .Qq Ar id Ns Cm :grab_focus
2315 puts the keyboard focus onto the socket.
2317 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2318 makes the socket grayed out
2323 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2326 the socket, or makes it visible
2329 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2330 sets the socket's tooltip.
2331 Default is disabling the tooltip.
2332 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2333 writes a snapshot of the socket to an image file of the specified
2336 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2337 sets the socket's minimum size to
2341 Default is the socket's natural size.
2345 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2351 .Qq Ar id Ns Cm :id Ar xid
2352 can be used by another process to XEmbed its widgets into the
2355 .Qq Ar id Ns Cm \&:plug-added ,
2357 .Ar id Ns Cm \&:plug-removed
2359 Notification that the other process has inserted its widgets into or
2360 removed them from the
2364 .Bl -tag -width "commands "
2366 .Qq Ar id Ns Cm :set_text Ar string
2367 sets the selected value to
2370 .Qq Ar id Ns Cm :set_range Ar min max
2373 .Qq Ar id Ns Cm :set_increments Ar step page
2374 sets the steps the value changes while pressing arrow keys/left mouse
2377 .Pf / Ql Page_Down Ns
2378 /middle mouse button,
2381 .Qq Ar id Ns Cm :grab_focus
2382 puts the keyboard focus onto the button.
2384 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2385 makes the button grayed out
2390 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2393 the button, or makes it visible
2396 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
2402 Initially, the button is unblocked.
2404 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2405 sets the button's tooltip.
2406 Default is disabling the tooltip.
2408 .Qq Ar id Ns Cm :force
2409 simulates fresh selection of the current value
2411 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2412 writes a snapshot of the button to an image file of the specified
2415 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2416 sets the button's minimum size to
2420 Default is the widget's natural size.
2424 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2426 sets the button's style.
2430 .Qq Ar id Ns Cm \&:text Ar text
2433 .Bl -tag -width "commands "
2435 .Qq Ar id Ns Cm :start
2437 .Qq Ar id Ns Cm :stop
2438 start and stop the spinner.
2440 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2441 makes the spinner grayed out
2446 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2449 the spinner, or makes it visible
2452 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2453 sets the spinner's tooltip.
2454 Default is disabling the tooltip.
2456 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2457 writes a snapshot of the spinner to an image file of the specified
2460 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2461 sets the spinner's minimum size to
2465 Default is the natural size.
2469 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2478 The context parameter
2480 is an arbitrary non-whitespace string.
2481 .Bl -tag -width "commands "
2483 .Qq Ar id Ns Cm :push_id Ar c string ,
2484 .Qq Ar id Ns Cm :push Ar string
2487 with context parameter
2491 respectively, and display it in the statusbar.
2493 .Qq Ar id Ns Cm :pop_id Ar c ,
2494 .Qq Ar id Ns Cm :pop
2495 remove the latest entry associated with context parameter
2499 respectively, from the statusbar.
2501 .Qq Ar id Ns Cm :remove_all_id Ar c ,
2502 .Qq Ar id Ns Cm :remove_all
2503 remove the entries associated with context parameter
2507 respectively, from the statusbar.
2509 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2510 makes the statusbar grayed out
2515 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2518 the statusbar, or makes it visible
2521 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2522 sets the statusbar's tooltip.
2523 Default is disabling the tooltip.
2525 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2526 writes a snapshot of the statusbar to an image file of the specified
2529 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2530 sets the statusbar's minimum size to
2534 Default is the natural size.
2538 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2540 sets the statusbar's style.
2547 .Bl -tag -width "commands "
2549 .Qq Ar id Ns Cm :set_active Brq Cm 0 Ns | Ns Cm 1
2550 turns the switch off
2555 .Qq Ar id Ns Cm :grab_focus
2556 puts the keyboard focus onto the switch.
2558 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2559 makes the switch grayed out
2564 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2567 the switch, or makes it visible
2570 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
2576 Initially, the switch is unblocked.
2578 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2579 sets the tooltip of the switch.
2580 Default is disabling the tooltip.
2582 .Qq Ar id Ns Cm :force
2583 simulates a click on the switch.
2585 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2586 writes a snapshot of the switch to an image file of the specified
2589 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2590 sets the switch's minimum size to
2594 Default is the natural size.
2598 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2604 .Qq Ar id Ns Cm \&:1
2606 .Qq Ar id Ns Cm \&:0
2610 There should be a dedicated
2612 for sending (parts of) the text.
2620 .Ar foo Ns Cm _send_text
2621 will send the content of the
2626 .Ar foo Ns Cm _send_selection
2627 will send the highlighted part the
2629 .Bl -tag -width "commands "
2631 .Qq Ar id Ns Cm :set_text Ar string
2632 replaces the user-editable text with (potentially empty)
2635 .Qq Ar id Ns Cm :delete
2638 .Qq Ar id Ns Cm :insert_at_cursor Ar string
2643 .Qq Ar id Ns Cm :place_cursor Brq Ar position | Cm end
2644 places the text cursor at
2646 or at the end of the text.
2648 .Qq Ar id Ns Cm :place_cursor_at_line Ar line
2649 places the text cursor at the beginning of
2652 .Qq Ar id Ns Cm :scroll_to_cursor
2653 scrolls to the cursor position if necessary.
2655 .Qq Ar id Ns Cm :save Ar file
2660 command containing the text.
2662 .Qq Ar id Ns Cm :grab_focus
2663 puts the keyboard focus into the textview.
2665 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2666 makes the text view grayed out
2671 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2674 the text view, or makes it visible
2677 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2678 sets the tooltip of the text view.
2679 Default is disabling the tooltip.
2681 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2682 writes a snapshot of the text view to an image file of the specified
2685 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2686 sets the minimum size to
2690 Default is the natural size.
2694 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2700 .Qq Ar button_id Ns Cm \&:text Ar text ,
2708 and backslashes are replaced by
2712 .Bl -tag -width "commands "
2714 .Qq Ar id Ns Cm :set_active Brq Cm 0 Ns | Ns Cm 1
2715 switches the button off
2720 .Qq Ar id Ns Cm :set_label Ar string
2721 replaces the button text with
2724 .Qq Ar id Ns Cm :grab_focus
2725 puts the keyboard focus onto the button.
2727 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2728 makes the button grayed out
2733 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2736 the button, or makes it visible
2739 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
2745 Initially, the button is unblocked.
2747 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2748 sets the button's tooltip.
2749 Default is disabling the tooltip.
2751 .Qq Ar id Ns Cm :force
2752 simulates a click on the button.
2754 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2755 writes a snapshot of the button to an image file of the specified
2758 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2759 sets the button's minimum size to
2763 Default is the button's natural size.
2767 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2769 sets the button's style.
2773 .Qq Ar id Ns Cm \&:1
2775 .Qq Ar id Ns Cm \&:0
2780 can deal with columns of type
2781 .Cm gboolean , gint , guint , glong , gulong , gint64 , guint64 , gfloat , gdouble ,
2788 refer to the underlying model
2791 .Cm GtkTreeStore ) .
2793 is a sequence of one or more colon-separated integers, e.g.
2797 .Bl -tag -width "commands "
2799 .Qq Ar id Ns Cm :set Ar row column data
2800 replaces the content at
2804 (which should be compatible with the type of
2806 If necessary, new tree nodes are created to obtain the minimal tree
2807 structure needed to support
2810 .Qq Ar id Ns Cm :insert_row Brq Ar row Bo Cm as_child Bc | Cm end
2811 inserts a new, empty row; either as a sibling of
2817 or at the end of the list, respectively.
2819 .Qq Ar id Ns Cm :move_row Ar origin Brq Ar destination | Cm end
2822 within its current level to
2826 .Qq Ar id Ns Cm :remove_row Ar row
2827 removes the row at position
2830 .Qq Ar id Ns Cm :clear
2833 .Qq Ar id Ns Cm :expand Ar row
2834 expands one level of the subtree below
2837 .Qq Ar id Ns Cm :expand_all Bq Ar row
2838 expands the subtree below
2842 .Qq Ar id Ns Cm :collapse Bq Ar row
2843 collapses the subtree below
2847 .Qq Ar id Ns Cm :set_cursor Bq Ar row
2852 .Qq Ar id Ns Cm :scroll Ar row column
2857 .Qq Ar id Ns Cm :save Ar file
2858 stores the content of the underlying model as a sequence of
2863 .Qq Ar id Ns Cm :grab_focus
2864 puts the keyboard focus onto the tree view.
2866 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2867 makes the tree view grayed out
2872 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2875 the tree view, or makes it visible
2878 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
2883 .Cm GtkTreeSelection
2890 Initially, the widget is unblocked.
2892 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2893 sets the tooltip of the tree view.
2894 Default is disabling the tooltip.
2896 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2897 writes a snapshot of the tree view to an image file of the specified
2900 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2901 sets the minimum size of the tree view to
2905 Default is the widget's natural size.
2909 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2915 .Qq Ar id Ns Cm \&:clicked
2917 .Qq Ar id Ns Cm \&: Ns Ar column_type row column value ,
2918 one message per cell in the underlying model for each selected row; or
2920 .Qq Ar id Ns Cm \&: Ns Ar column_type row column new_value ,
2925 .Ss GtkTreeViewColumn
2926 .Bl -tag -width "commands "
2928 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
2934 Initially, the widget is unblocked.
2936 .Qq Ar id Ns Cm \&:clicked
2939 .Bl -tag -width "commands "
2941 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
2942 makes the viewport insensitive
2947 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
2950 the viewport, or makes it visible
2953 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
2954 sets the tooltip of the viewport.
2955 Default is disabling the tooltip.
2957 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
2958 writes a snapshot of the viewport to an image file of the specified
2961 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
2962 sets the minimum size to
2966 Default is the natural size of the viewport.
2970 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
2972 sets the widget style.
2979 .Bl -tag -width "commands "
2981 .Qq Ar id Ns Cm :set_title Ar string
2982 replaces the text in the title bar with
2985 .Qq Ar id Ns Cm :resize Bq Ar width height
2986 changes the window size to
2990 pixels if specified, or to the default size.
2992 .Qq Ar id Ns Cm :move Ar x y
2993 moves the window to position
2996 .Qq Ar id Ns Cm :fullscreen
2998 .Qq Ar id Ns Cm :unfullscreen
2999 switch fullscreen mode on and off.
3001 .Qq Ar id Ns Cm :set_sensitive Brq Cm 0 Ns | Ns Cm 1
3002 makes the widget grayed out
3007 .Qq Ar id Ns Cm :set_visible Brq Cm 0 Ns | Ns Cm 1
3010 the widget, or makes it visible
3013 .Qq Ar id Ns Cm :block Brq Cm 0 Ns | Ns Cm 1
3019 Initially, the widget is unblocked.
3021 .Qq Ar id Ns Cm :set_tooltip_text Bq Ar text
3022 sets the window's tooltip.
3023 Default is disabling the tooltip.
3024 .Qq Ar id Ns Cm :snapshot Ar file Ns Brq Cm .ps Ns | Ns Cm .eps Ns | Ns Cm .epsf Ns | Ns Cm .pdf Ns | Ns Cm .svg
3025 writes a snapshot of the window to an image file of the specified
3028 .Qq Ar id Ns Cm :set_size_request Bq Ar width height
3029 sets the window's minimum size to
3033 Default is the widget's natural size.
3037 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
3043 .Qq Ar id Ns Cm \&:closed
3046 was closed by the window manager.
3052 .Bo Ar prop Ns Cm \&: Ns Ar val Ns Bo Cm \&; Ar prop Ns Cm \&: Ns Ar val ... Bc Bc
3056 of the widget style to
3058 Properties not explicitly specified are reset to their default values.
3060 .Bl -dash -offset indent -compact
3062 .Ql label1:style font:Bold 11; background-color:green
3064 .Ql label1:style font-style:italic; font-weight:bold; color:blue
3066 .Ql button1:style background-image:url("q.png")
3068 .Ql treeview1:style background-image:linear-gradient(45deg, yellow, blue);
3070 .Ql frame1:style border-color:red yellow; border-width:5px
3072 .Ql frame1:style border-radius:10px; transition:10s
3074 For color notations see
3081 .Bl -dash -offset indent -compact
3083 standard X11 colors names like
3085 .Ql Dark Sea Green ,
3091 hexadecimal values in the form
3092 .Cm # Ns Ar rgb , Cm # Ns Ar rrggbb , Cm # Ns Ar rrrgggbbb ,
3094 .Cm # Ns Ar rrrrggggbbbb ;
3096 RGB colors in the form
3097 .Cm rgb( Ns Ar red Ns Cm \&, Ns Ar green Ns Cm \&, Ns Ar blue Ns Cm \&)
3099 RGBA colors in the form
3100 .Cm rgba( Ns Ar red Ns Cm \&, Ns Ar green Ns Cm \&, Ns
3101 .Ar blue Ns Cm \&, Ns Ar alpha Ns Cm \&) ;
3102 .Ar red , green , blue
3103 between 0 and 255 and
3107 color expressions like
3110 .Ql lighter(currentColor) .
3115 .Ss Discovering Pipeglade Interactively
3116 Suppose the interface in
3119 .Sx GtkLabel Ql label1
3121 .Sx GtkButton Ql button1 .
3127 .Sx GtkButton , Ql button1:clicked
3128 will be reported on the terminal.
3131 .Dl label1:set_text The Button
3133 will change the text shown on the label into
3135 .Ss One-Shot File Dialog
3136 Suppose the interface in
3137 .Pa ./simple_open.ui
3139 .Sx GtkFileChooserDialog
3147 .Dl pipeglade -u simple_open.ui
3149 will open the dialog; pressing
3151 will close it after sending the selected filename to
3153 .Ss One-Shot User Notification
3155 .Pa ./simple_dialog.ui
3157 .Sx GtkLabel Ql label1 ,
3159 .Bd -literal -offset indent
3160 pipeglade -u simple_dialog.ui <<< \e
3161 "label1:set_text NOW READ THIS!"
3163 will set the label text accordingly and wait for user input.
3164 .Ss Continuous Input
3165 The following shell command displays a running clock:
3166 .Bd -literal -offset indent
3168 echo "label1:set_text `date`";
3170 done | pipeglade -u simple_dialog.ui
3172 .Ss Continuous Input and Output
3173 The following shell script fragment sets up
3175 for continuous communication with another program,
3177 .Bd -literal -offset indent
3178 pipeglade -i in.fifo -o out.fifo -b
3179 main_prog <out.fifo >in.fifo
3192 .An Bert Burgemeister
3193 .Aq Mt trebbu@googlemail.com .
3195 Due to what appears to be a bug in cairo v1.14.0,
3197 used with this library version occasionally crashes on