gtk Constants — the built-in constants of the gtk module
The Accel Flags constants are a set of bit-flags that specify characteristics of the accelerator.
gtk.ACCEL_VISIBLE | if set, the accelerator is visible in a label |
gtk.ACCEL_LOCKED | If set the accelerator cannot be changed by the user. |
gtk.ACCEL_MASK | A mask for the Accel Flags |
The Anchor Type constants specify the anchor point of a widget.
gtk.ANCHOR_CENTER | |
gtk.ANCHOR_NORTH | |
gtk.ANCHOR_NORTH_WEST | |
gtk.ANCHOR_NORTH_EAST | |
gtk.ANCHOR_SOUTH | |
gtk.ANCHOR_SOUTH_WEST | |
gtk.ANCHOR_SOUTH_EAST | |
gtk.ANCHOR_WEST | |
gtk.ANCHOR_EAST, | |
gtk.ANCHOR_N | Same as gtk.ANCHOR_NORTH |
gtk.ANCHOR_NW | Same as gtk.ANCHOR_NORTH_WEST |
gtk.ANCHOR_NE | Same as gtk.ANCHOR_NORTH_EAST |
gtk.ANCHOR_S | Same as gtk.ANCHOR_SOUTH |
gtk.ANCHOR_SW | Same as gtk.ANCHOR_SOUTH_WEST |
gtk.ANCHOR_SE | Same as gtk.ANCHOR_SOUTH_EAST |
gtk.ANCHOR_W | Same as gtk.ANCHOR_WEST |
gtk.ANCHOR_E | Same as gtk.ANCHOR_EAST |
The Arrow Type constants specify the direction a gtk.Arrow should point.
gtk.ARROW_UP | Represents an upward pointing arrow. |
gtk.ARROW_DOWN | Represents a downward pointing arrow. |
gtk.ARROW_LEFT | Represents a left pointing arrow. |
gtk.ARROW_RIGHT | Represents a right pointing arrow. |
The Assistant Page Type constants are used to determine the page role inside the gtk.Assistant. It's used to handle buttons sensitivity and visibility.
An assistant needs to end its page flow with a page of type gtk.ASSISTANT_PAGE_CONFIRM or gtk.ASSISTANT_PAGE_SUMMARY to be correct.
gtk.ASSISTANT_PAGE_CONTENT | The page has regular contents. |
gtk.ASSISTANT_PAGE_INTRO | The page contains an introduction to the assistant task. |
gtk.ASSISTANT_PAGE_CONFIRM | The page lets the user confirm or deny the changes. |
gtk.ASSISTANT_PAGE_SUMMARY | The page informs the user of the changes done. |
gtk.ASSISTANT_PAGE_PROGRESS | Used for tasks that take a long time to complete, blocks the assistant until the page is marked as complete. |
The Attach Flag Options constants are a set of bit-flags that specify the expansion properties that a widget will have when it (or its parent) is resized.
gtk.EXPAND | The widget should expand to take up any extra space in its container that has been allocated. |
gtk.SHRINK | The widget should shrink as and when possible. |
gtk.FILL | The widget should fill the space allocated to it. |
The ButtonBox Style constants specify the style that a gtk.ButtonBox uses to layout the buttons it contains. (See also: gtk.VButtonBox and gtk.HButtonBox).
gtk.BUTTONBOX_DEFAULT_STYLE | Default packing. |
gtk.BUTTONBOX_SPREAD | Buttons are evenly spread across the ButtonBox. |
gtk.BUTTONBOX_EDGE | Buttons are placed at the edges of the ButtonBox. |
gtk.BUTTONBOX_START | Buttons are grouped toward the start of box, (on the left for a HBox, or the top for a VBox). |
gtk.BUTTONBOX_END | Buttons are grouped toward the end of a box, (on the right for a HBox, or the bottom for a VBox). |
The Buttons Type constants specify the pre-defined sets of buttons for the dialog. If none of these choices are appropriate, simply use gtk.BUTTONS_NONE then call the add_buttons() method.
gtk.BUTTONS_NONE | no buttons at all |
gtk.BUTTONS_OK | an OK button |
gtk.BUTTONS_CLOSE | a Close button |
gtk.BUTTONS_CANCEL | a Cancel button |
gtk.BUTTONS_YES_NO | Yes and No buttons |
gtk.BUTTONS_OK_CANCEL | OK and Cancel buttons |
The Calendar Display Options constants are a set of bit-flags that specify the display and behavior of a gtk.Calendar.
gtk.CALENDAR_SHOW_HEADING | Specifies that the month and year should be displayed. |
gtk.CALENDAR_SHOW_DAY_NAMES | Specifies that three letter day descriptions should be present. |
gtk.CALENDAR_NO_MONTH_CHANGE | Prevents the user from switching months with the calendar. |
gtk.CALENDAR_SHOW_WEEK_NUMBERS | Displays each week numbers of the current year, down the left side of the calendar. |
gtk.CALENDAR_WEEK_START_MONDAY | Since GTK+ 2.4, this option is deprecated and ignored by GTK+. The information on which day the calendar week starts is derived from the locale. |
The CellRenderer Mode constants specify how the user can interact with a particular cell.
gtk.CELL_RENDERER_MODE_INERT | The cell is just for display and cannot be interacted with. Note that this doesn't mean that e.g. the row being drawn can't be selected -- just that a particular element of it cannot be individually modified. |
gtk.CELL_RENDERER_MODE_ACTIVATABLE | The cell can be clicked. |
gtk.CELL_RENDERER_MODE_EDITABLE | The cell can be edited or otherwise modified. |
The CellRenderer State constants specify how a cell is to be rendered.
gtk.CELL_RENDERER_SELECTED | The cell is currently selected, and probably has a selection colored background to render to. |
gtk.CELL_RENDERER_PRELIT | The mouse is hovering over the cell. |
gtk.CELL_RENDERER_INSENSITIVE | The cell is drawn in an insensitive manner |
gtk.CELL_RENDERER_SORTED | The cell is in a sorted row |
gtk.CELL_RENDERER_FOCUSED | The cell has the focus. |
The CellRendererAccel Mode constants specify if the edited accelerators are GTK+ accelerators. If they are, consumed modifiers are suppressed, only accelerators accepted by GTK+ are allowed, and the accelerators are rendered in the same way as they are in menus.
gtk.CELL_RENDERER_ACCEL_MODE_GTK | Only accelerators accepted by GTK+ are allowed. |
gtk.CELL_RENDERER_ACCEL_MODE_OTHER | Any accelerators are allowed. |
The Corner Type constants specify the corner a child widget should be placed in when packed into a gtk.ScrolledWindow. This is effectively the opposite of where the scroll bars are placed.
gtk.CORNER_TOP_LEFT | Place the scrollbars on the right and bottom of the widget (default behavior). |
gtk.CORNER_BOTTOM_LEFT | Place the scrollbars on the top and right of the widget. |
gtk.CORNER_TOP_RIGHT | Place the scrollbars on the left and bottom of the widget. |
gtk.CORNER_BOTTOM_RIGHT | Place the scrollbars on the top and left of the widget. |
The Curve Type constants specify the type of curve to use for a gtk.Curve.
gtk.CURVE_TYPE_LINEAR | Linear interpolation |
gtk.CURVE_TYPE_SPLINE | Spline interpolation |
gtk.CURVE_TYPE_FREE | Free form curve |
The Debug Flag constants are a set of bit-flags that specify the debug options.
gtk.DEBUG_MISC | |
gtk.DEBUG_PLUGSOCKET | |
gtk.DEBUG_TEXT | |
gtk.DEBUG_TREE | |
gtk.DEBUG_UPDATES | |
gtk.DEBUG_KEYBINDINGS | |
gtk.DEBUG_MULTIHEAD |
The Delete Type constants specify the deletion type.
gtk.DELETE_CHARS | Delete a character at the cursor |
gtk.DELETE_WORD_ENDS | Delete from the cursor to the end of a word |
gtk.DELETE_WORDS | Delete a number of words |
gtk.DELETE_DISPLAY_LINES | Delete a single line at the cursor |
gtk.DELETE_DISPLAY_LINE_ENDS, | Delete from the cursor to the end of the line. |
gtk.DELETE_PARAGRAPH_ENDS | Delete from the cursor to a paragraph end (usually to the period) |
gtk.DELETE_PARAGRAPHS | Delete several complete paragraphs at the cursor |
gtk.DELETE_WHITESPACE | Delete the whitespace at the cursor. |
The Dest Defaults constants are a set of bit-flags that specify the various types of action that will be taken on behalf of the user for a drag destination site.
gtk.DEST_DEFAULT_MOTION | If set for a widget, during a drag over this widget will check if the drag matches this widget's list of possible targets and actions. The gtk.gdk.DragContext.drag_status() method will be called as appropriate. |
gtk.DEST_DEFAULT_HIGHLIGHT | If set for a widget, draw a highlight on this widget as long as a drag is over this widget and the widget drag format and action are acceptable. |
gtk.DEST_DEFAULT_DROP | If set for a widget, when a drop occurs, check if the drag matches this widget's list of possible targets and actions. If so, call the gtk.Widget.drag_get_data() method on behalf of the widget. Whether or not the drop is successful, call the gtk.gdk.DragContext.finish() method. If the action was a move, then if the drag was successful, then TRUE will be passed for the delete parameter to the gtk.gdk.DragContext.finish() method. |
gtk.DEST_DEFAULT_ALL | If set, specifies that all default actions should be taken. |
The Dialog Flag constants are a set of bit-flags that specify characteristics of a dialog.
gtk.DIALOG_MODAL | If set, the dialog grabs all keyboard events |
gtk.DIALOG_DESTROY_WITH_PARENT | If set, the dialog is destroyed when its parent is. |
gtk.DIALOG_NO_SEPARATOR | If set, there is no separator bar above the buttons. |
The Direction Type constants specify a direction for moving a cursor or focus.
gtk.DIR_TAB_FORWARD | Tab forward. |
gtk.DIR_TAB_BACKWARD | Tab backward. |
gtk.DIR_UP | Up. |
gtk.DIR_DOWN | Down. |
gtk.DIR_LEFT | Left. |
gtk.DIR_RIGHT | Right. |
The Expander Style constants specify the style of the expanders drawn by a gtk.TreeView
gtk.EXPANDER_COLLAPSED | The style used for a collapsed subtree. |
gtk.EXPANDER_SEMI_COLLAPSED | Intermediate style used during animation. |
gtk.EXPANDER_SEMI_EXPANDED | Intermediate style used during animation. |
gtk.EXPANDER_EXPANDED | The style used for an expanded subtree. |
The FileChooser Action constants specify the mode of a gtk.FileChooser i.e. whether it is being used to open existing files or to save to a possibly new file.
gtk.FILE_CHOOSER_ACTION_OPEN | Indicates open mode. The file chooser will only let the user pick an existing file. |
gtk.FILE_CHOOSER_ACTION_SAVE | Indicates save mode. The file chooser will let the user pick an existing file, or type in a new filename. |
gtk.FILE_CHOOSER_ACTION_SELECT_FOLDER | Indicates an Open mode for selecting folders. The file chooser will let the user pick an existing folder. |
gtk.FILE_CHOOSER_ACTION_CREATE_FOLDER | Indicates a mode for creating a new folder. The file chooser will let the user name an existing or new folder. |
These constants are available in PyGTK 2.8 and above.
The FileChooser Confirmation constants are used to specify the return value of a gtk.FileChooser "confirm-overwrite" signal handler. This value determines whether the file chooser will present the stock confirmation dialog, accept the user's choice of a filename, or let the user choose another filename.
gtk.FILE_CHOOSER_CONFIRMATION_CONFIRM | The file chooser will present its stock dialog to confirm overwriting an existing file. |
gtk.FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME | The file chooser will terminate and accept the user's choice of a file name. |
gtk.FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN | The file chooser will continue running, allowing the user to select another file name. |
The FileChooser Error constants specify the various errors that can occur while calling gtk.FileChooser functions.
gtk.FILE_CHOOSER_ERROR_NONEXISTENT | Indicates that a file does not exist. |
gtk.FILE_CHOOSER_ERROR_BAD_FILENAME | Indicates a malformed filename. |
The FileFilter Flags constants are a set of bit-flags that specify the file types to filter the files against.
gtk.FILE_FILTER_FILENAME | The full pathname of the file e.g. /tmp/junk. |
gtk.FILE_FILTER_URI | The full URI of the file e.g. file:///tmp/junk. |
gtk.FILE_FILTER_DISPLAY_NAME | The simple name of the file e.g. junk. |
gtk.FILE_FILTER_MIME_TYPE | The MIME type of the file e.g. text/html. |
The Icon Lookup Flags constants are a set of bit-flags that specify options for the gtk.IconTheme.lookup_icon() method
gtk.ICON_LOOKUP_NO_SVG | Never return SVG (Scalable Vector Graphics) icons, even if gdk-pixbuf supports them. Cannot be used together with gtk.ICON_LOOKUP_FORCE_SVG. |
gtk.ICON_LOOKUP_FORCE_SVG | Return SVG icons, even if gdk-pixbuf doesn't support them. Cannot be used together with gtk.ICON_LOOKUP_NO_SVG. |
gtk.ICON_LOOKUP_USE_BUILTIN | When passed to the gtk.IconTheme.lookup_icon() method includes builtin icons as well as files. For a builtin icon, the gtk.IconInfo.get_filename() method returns None and you need to call the gtk.IconInfo.get_builtin_pixbuf() method. |
The Icon Size constants specify the pre-defined sizes of icons for various application uses.
gtk.ICON_SIZE_INVALID | |
gtk.ICON_SIZE_MENU | |
gtk.ICON_SIZE_SMALL_TOOLBAR | |
gtk.ICON_SIZE_LARGE_TOOLBAR | |
gtk.ICON_SIZE_BUTTON | |
gtk.ICON_SIZE_DND | |
gtk.ICON_SIZE_DIALOG |
The IconTheme Error constants specify error codes for gtk.IconTheme operations.
gtk.ICON_THEME_NOT_FOUND | The icon specified does not exist in the theme |
gtk.ICON_THEME_FAILED | An unspecified error occurred. |
The IconView Drop Position constants specify the location relative to the receiving item where the drop should take place.
gtk.ICON_VIEW_NO_DROP | |
gtk.ICON_VIEW_DROP_INTO | |
gtk.ICON_VIEW_DROP_LEFT | |
gtk.ICON_VIEW_DROP_RIGHT | |
gtk.ICON_VIEW_DROP_ABOVE | |
gtk.ICON_VIEW_DROP_BELOW |
The IM Pre-edit Style constants specify the style of input method pre-edit display.
gtk.IM_PREEDIT_NOTHING | |
gtk.IM_PREEDIT_CALLBACK | |
gtk.IM_PREEDIT_NONE |
The IM Status Style constants specify the style of input method display.
gtk.IM_STATUS_NOTHING | |
gtk.IM_STATUS_CALLBACK | |
gtk.IM_STATUS_NONE |
The Image Type constants specify the type of image in a gtk.Image.
gtk.IMAGE_EMPTY | There is no image displayed by the widget |
gtk.IMAGE_PIXMAP | The widget contains a gtk.gdk.Pixmap |
gtk.IMAGE_IMAGE | The widget contains a gtk.gdk.Image |
gtk.IMAGE_PIXBUF | The widget contains a gtk.gdk.Pixbuf |
gtk.IMAGE_STOCK | The widget contains a stock icon name (see the Stock Items reference) |
gtk.IMAGE_ICON_SET | The widget contains a gtk.IconSet |
gtk.IMAGE_ANIMATION | The widget contains a gtk.gdk.PixbufAnimation |
The Justification constants specify the justification of the text inside a gtk.Label widget. (See also gtk.Alignment).
gtk.JUSTIFY_LEFT | The text is placed at the left edge of the label. |
gtk.JUSTIFY_RIGHT | The text is placed at the right edge of the label. |
gtk.JUSTIFY_CENTER | The text is placed in the center of the label. |
gtk.JUSTIFY_FILL | The text is placed is distributed across the label. |
The Menu Direction Type constants specify directional movements within a menu.
gtk.MENU_DIR_PARENT | To the parent menu shell. |
gtk.MENU_DIR_CHILD | To the submenu, if any, associated with the item. |
gtk.MENU_DIR_NEXT | To the next menu item. |
gtk.MENU_DIR_PREV | To the previous menu item. |
The Message Type constants specify the type of message being displayed in the message dialog.
gtk.MESSAGE_INFO | Informational message |
gtk.MESSAGE_WARNING | Nonfatal warning message |
gtk.MESSAGE_QUESTION | Question requiring a choice |
gtk.MESSAGE_ERROR | Fatal error message |
The Metric Type constants specify the metric used by a gtk.Ruler.
gtk.PIXELS | Pixels. |
gtk.INCHES | Inches. |
gtk.CENTIMETERS | Centimeters. |
The Movement Step constants specify the steps used in movement through text.
gtk.MOVEMENT_LOGICAL_POSITIONS | move by graphemes |
gtk.MOVEMENT_VISUAL_POSITIONS | move by graphemes |
gtk.MOVEMENT_WORDS | move by words |
gtk.MOVEMENT_DISPLAY_LINES | move by lines(wrapped lines) |
gtk.MOVEMENT_DISPLAY_LINE_ENDS | move to line ends(wrapped lines) |
gtk.MOVEMENT_PARAGRAPHS | move by paragraphs(newline-ended lines) |
gtk.MOVEMENT_PARAGRAPH_ENDS | move to ends of a paragraph |
gtk.MOVEMENT_PAGES | move by pages |
gtk.MOVEMENT_BUFFER_ENDS | move to ends of the buffer |
The Notebook Tab constants specify the tab position to receive focus.
gtk.NOTEBOOK_TAB_FIRST | The first gtk.Notebook tab |
gtk.NOTEBOOK_TAB_LAST | The last gtk.Notebook tab |
The Object Flags constants are a set of bit-flags that specify the state of the gtk.Object.
gtk.IN_DESTRUCTION | The object is currently being destroyed. This is used internally to prevent reinvocations during destruction. |
gtk.FLOATING | The object is orphaned. |
The Orientation constants specify the orientation of widgets which can be switched between horizontal and vertical orientation on the fly, like gtk.Toolbar.
gtk.ORIENTATION_HORIZONTAL | The widget is in horizontal orientation. |
gtk.ORIENTATION_VERTICAL | The widget is in vertical orientation. |
The Pack Direction constants specify the arrangement of gtk.MenuItems in a gtk.MenuBar or in a child gtk.MenuItem of a menubar.
gtk.ACK_DIRECTION_LTR | Pack left to right |
gtk.PACK_DIRECTION_RTL | Pack right to left |
gtk.PACK_DIRECTION_TTB | Pack top to bottom |
gtk.PACK_DIRECTION_BTT | Pack bottom to top |
The Pack Type constants specify the packing location gtk.Box children. (See: gtk.VBox, gtk.HBox, and gtk.ButtonBox).
gtk.PACK_START | The child is packed into the start of the box |
gtk.PACK_END | The child is packed into the end of the box |
The Page Orientation constants specify the orientation of a page.
gtk.PAGE_ORIENTATION_PORTRAIT | |
gtk.PAGE_ORIENTATION_LANDSCAPE | |
gtk.PAGE_ORIENTATION_REVERSE_PORTRAIT | |
gtk.PAGE_ORIENTATION_REVERSE_LANDSCAPE |
The Page Set constants specify the set of pages to print.
gtk.PAGE_SET_ALL | print all pages |
gtk.PAGE_SET_EVEN | print even pages only |
gtk.PAGE_SET_ODD | print odd pages only |
The Paper Name constants specify the common standard sizes of paper as a string.
gtk.PAPER_NAME_A3 | Name for the A4 paper size. |
gtk.PAPER_NAME_A4 | Name for the A4 paper size. |
gtk.PAPER_NAME_A5 | Name for the A5 paper size. |
gtk.PAPER_NAME_B5 | Name for the B5 paper size. |
gtk.PAPER_NAME_LETTER | Name for the Letter paper size. |
gtk.PAPER_NAME_EXECUTIVE | Name for the Executive paper size. |
gtk.Name for the Legal paper size. |
The Path Priority Type constants are a set of bit-flags that specify the priority of path lookup.
gtk.PATH_PRIO_LOWEST | |
gtk.PATH_PRIO_GTK | |
gtk.PATH_PRIO_APPLICATION | |
gtk.PATH_PRIO_THEME | |
gtk.PATH_PRIO_RC | |
gtk.PATH_PRIO_HIGHEST |
The Path Type constants specify
gtk.PATH_WIDGET | |
gtk.PATH_WIDGET_CLASS | |
gtk.PATH_CLASS |
The Policy Type constants specify when a scroll bar will be visible.
gtk.POLICY_ALWAYS | the scrollbar is always present |
gtk.POLICY_AUTOMATIC | the scrollbar is present only if needed i.e. the contents are larger than the window |
gtk.POLICY_NEVER | the scrollbar is never present |
The Position Type constants specify
gtk.POS_LEFT | The feature is at the left edge. |
gtk.POS_RIGHT | The feature is at the right edge. |
gtk.POS_TOP | The feature is at the top edge. |
gtk.POS_BOTTOM | The feature is at the bottom edge |
The Print Status constants specify how the output pages should be duplexed:
gtk.PRINT_DUPLEX_SIMPLEX | one page per sheet i.e. no duplexing |
gtk.PRINT_DUPLEX_HORIZONTAL | two pages per sheet horizontally duplexed |
gtk.PRINT_DUPLEX_VERTICAL | two pages per sheet vertically duplexed |
The Print Error constants specify the type of printing error:
gtk.PRINT_ERROR_GENERAL | |
gtk.PRINT_ERROR_INTERNAL_ERROR | |
gtk.PRINT_ERROR_NOMEM |
The Print Pages constants specify the set that should be printed:
gtk.PRINT_PAGES_ALL | print all pages |
gtk.PRINT_PAGES_CURRENT | print the current page |
gtk.PRINT_PAGES_RANGES | print the specified ranges of pages |
The Print Operation Action constants specify the print operation to be performed:
gtk.PRINT_OPERATION_ACTION_PRINT_DIALOG | Show the print dialog. |
gtk.PRINT_OPERATION_ACTION_PRINT | Start to print without showing the print dialog, based on the current print settings. |
gtk.PRINT_OPERATION_ACTION_PREVIEW | Show the print preview. |
gtk.PRINT_OPERATION_ACTION_EXPORT | Export to a file. This requires the "export-filename" property to be set. |
The Print Operation Result constants specify the result of the print operation as returned by the gtk.PrintOperation.run()) method:
gtk.PRINT_OPERATION_RESULT_ERROR | An error has occured. |
gtk.PRINT_OPERATION_RESULT_APPLY | The print settings should be stored. |
gtk.PRINT_OPERATION_RESULT_CANCEL | The print operation has been canceled, the print settings should not be stored. |
gtk.PRINT_OPERATION_RESULT_IN_PROGRESS | The print operation is complete yet. This value will only be returned when running asynchronously. |
The Print Quality constants specify the quality that should be used when printing the output pages:
gtk.PRINT_QUALITY_LOW | low quality |
gtk.PRINT_QUALITY_NORMAL | normal quality |
gtk.PRINT_QUALITY_HIGH | high quality |
gtk.PRINT_QUALITY_DRAFT | draft quality |
The Print Status constants specify
gtk.PRINT_STATUS_INITIAL | The printing has not started yet; this status is set initially, and while the print dialog is shown. |
gtk.PRINT_STATUS_PREPARING | This status is set while the "begin-print" signal is emitted and during pagination. |
gtk.PRINT_STATUS_GENERATING_DATA | This status is set while the pages are being rendered. |
gtk.PRINT_STATUS_SENDING_DATA | The print job is being sent off to the printer. |
gtk.PRINT_STATUS_PENDING | The print job has been sent to the printer, but is not printed for some reason, e.g. the printer may be stopped. |
gtk.PRINT_STATUS_PENDING_ISSUE | Some problem has occurred during printing, e.g. a paper jam. |
gtk.PRINT_STATUS_PRINTING | The printer is processing the print job. |
gtk.PRINT_STATUS_FINISHED | The printing has been completed successfully. |
gtk.PRINT_STATUS_FINISHED_ABORTED | The printing has been aborted. |
The ProgressBar Orientation constants specify the orientation and growth direction for a visible progress bar.
gtk.PROGRESS_LEFT_TO_RIGHT | A horizontal progress bar growing from left to right. |
gtk.PROGRESS_RIGHT_TO_LEFT | A horizontal progress bar growing from right to left. |
gtk.PROGRESS_BOTTOM_TO_TOP | A vertical progress bar growing from bottom to top. |
gtk.PROGRESS_TOP_TO_BOTTOM | A vertical progress bar growing from top to bottom. |
The ProgressBar Style constants specify the style of the gtk.ProgressBar display.
gtk.PROGRESS_CONTINUOUS | The progress bar grows in a smooth, continuous manner. |
gtk.PROGRESS_DISCRETE | The progress bar grows in discrete, visible blocks. |
The>RC Flags constants are a set of bit-flags that specify which fields of a gtk.RcStyle have been set for each state.
gtk.RC_FG | If present, the foreground color has been set for this state. |
gtk.RC_BG | If present, the background color has been set for this state. |
gtk.RC_TEXT | If present, the text color has been set for this state. |
gtk.RC_BASE | If present, the base color has been set for this state. |
The RC Token Type constants specify the tokens in the RC file. It is exposed so that theme engines can reuse these tokens when parsing the theme-engine specific portions of a RC file.
gtk.RC_TOKEN_INVALID | |
gtk.RC_TOKEN_INCLUDE | |
gtk.RC_TOKEN_NORMAL | |
gtk.RC_TOKEN_ACTIVE | |
gtk.RC_TOKEN_PRELIGHT | |
gtk.RC_TOKEN_SELECTED | |
gtk.RC_TOKEN_INSENSITIVE | |
gtk.RC_TOKEN_FG | |
gtk.RC_TOKEN_BG | |
gtk.RC_TOKEN_TEXT | |
gtk.RC_TOKEN_BASE | |
gtk.RC_TOKEN_XTHICKNESS | |
gtk.RC_TOKEN_YTHICKNESS | |
gtk.RC_TOKEN_FONT | |
gtk.RC_TOKEN_FONTSET | |
gtk.RC_TOKEN_FONT_NAME | |
gtk.RC_TOKEN_BG_PIXMAP | |
gtk.RC_TOKEN_PIXMAP_PATH | |
gtk.RC_TOKEN_STYLE | |
gtk.RC_TOKEN_BINDING | |
gtk.RC_TOKEN_BIND | |
gtk.RC_TOKEN_WIDGET | |
gtk.RC_TOKEN_WIDGET_CLASS | |
gtk.RC_TOKEN_CLASS | |
gtk.RC_TOKEN_LOWEST | |
gtk.RC_TOKEN_GTK | |
gtk.RC_TOKEN_APPLICATION | |
gtk.RC_TOKEN_THEME | |
gtk.RC_TOKEN_RC | |
gtk.RC_TOKEN_HIGHEST | |
gtk.RC_TOKEN_ENGINE | |
gtk.RC_TOKEN_MODULE_PATH | |
gtk.RC_TOKEN_IM_MODULE_PATH | |
gtk.RC_TOKEN_IM_MODULE_FILE | |
gtk.RC_TOKEN_STOCK | |
gtk.RC_TOKEN_LTR | |
gtk.RC_TOKEN_RTL | |
gtk.RC_TOKEN_LAST |
The Recent Recent Chooser Error constants specify the various errors that can occur while calling gtk.RecentChooser methods:
gtk.RECENT_CHOOSER_ERROR_NOT_FOUND | Indicates that a file does not exist |
gtk.RECENT_CHOOSER_ERROR_INVALID_URI | Indicates a malformed URI |
The Recent Filter Flags specify what types of filtering are needed:
gtk.RECENT_FILTER_URI | the URI of the file being tested |
gtk.RECENT_FILTER_DISPLAY_NAME | the string that will be used to display the file in the recent chooser |
gtk.RECENT_FILTER_MIME_TYPE | the mime type of the file |
gtk.RECENT_FILTER_APPLICATION | the list of applications that have registered the file |
gtk.RECENT_FILTER_GROUP | the groups to which the file belongs |
gtk.RECENT_FILTER_AGE | the number of days elapsed since the file has been registered |
The Recent Sort Type constants specify the sorting method to be applyed to the recently used resource list.
gtk.RECENT_SORT_NONE | Do not sort the returned list of recently used resources. |
gtk.RECENT_SORT_MRU | Sort the returned list with the most recently used items first. |
gtk.RECENT_SORT_LRU | Sort the returned list with the least recently used items first. |
gtk.RECENT_SORT_CUSTOM | Sort the returned list using a custom sorting function passed using the gtk.RecentChooser.set_sort_func() method. |
The Relief Style constants specify
gtk.RELIEF_NORMAL | Draw a normal relief. |
gtk.RELIEF_HALF | Draw a half relief. |
gtk.RELIEF_NONE | Draw no relief. |
The Resize Mode constants specify how resize requests are handled by a widget.
gtk.RESIZE_PARENT | Pass resize request to the parent |
gtk.RESIZE_QUEUE | Queue resizes on this widget |
gtk.RESIZE_IMMEDIATE | Perform the resizes now |
The Response Type constants specify pre-defined response values.
gtk.RESPONSE_NONE | |
gtk.RESPONSE_REJECT | |
gtk.RESPONSE_ACCEPT | |
gtk.RESPONSE_DELETE_EVENT | |
gtk.RESPONSE_OK | |
gtk.RESPONSE_CANCEL | |
gtk.RESPONSE_CLOSE | |
gtk.RESPONSE_YES | |
gtk.RESPONSE_NO | |
gtk.RESPONSE_APPLY | |
gtk.RESPONSE_HELP |
The Scroll Step constants specify the size of the scroll movements.
gtk.SCROLL_STEPS | Scroll up or down in step increments |
gtk.SCROLL_PAGES, | Scroll up or down in page increments |
gtk.SCROLL_ENDS | Scroll to the beginning or end |
gtk.SCROLL_HORIZONTAL_STEPS | Scroll left or right in step increments |
gtk.SCROLL_HORIZONTAL_PAGES | Scroll left or right in step increments |
gtk.SCROLL_HORIZONTAL_ENDS | Scroll to the far left end or far right end. |
The Scroll Type constants specify the type of scroll \movement.
gtk.SCROLL_NONE | |
gtk.SCROLL_JUMP | |
gtk.SCROLL_STEP_BACKWARD | |
gtk.SCROLL_STEP_FORWARD | |
gtk.SCROLL_PAGE_BACKWARD | |
gtk.SCROLL_PAGE_FORWARD | |
gtk.SCROLL_STEP_UP | |
gtk.SCROLL_STEP_DOWN | |
gtk.SCROLL_PAGE_UP | |
gtk.SCROLL_PAGE_DOWN | |
gtk.SCROLL_STEP_LEFT, | |
gtk.SCROLL_STEP_RIGHT | |
gtk.SCROLL_PAGE_LEFT | |
gtk.SCROLL_PAGE_RIGHT | |
gtk.SCROLL_START | |
gtk.SCROLL_END |
The Selection Mode constants specify the mode of selection in a gtk.Treeview
gtk.SELECTION_NONE | No selection allowed. |
gtk.SELECTION_SINGLE | A single selection allowed by clicking. |
gtk.SELECTION_BROWSE | A single selection allowed by browsing with the pointer. |
gtk.SELECTION_MULTIPLE | Multiple items can be selected at once. |
gtk.SELECTION_EXTENDED | Deprecated. |
The Shadow Type constants specify the appearance of an outline typically provided by a gtk.Frame.
gtk.SHADOW_NONE | No outline. |
gtk.SHADOW_IN | The outline is beveled inward. |
gtk.SHADOW_OUT | The outline is beveled outward like a button. |
gtk.SHADOW_ETCHED_IN | The outline itself is an inward bevel, but the frame bevels outward |
gtk.SHADOW_ETCHED_OUT | The outline itself is an outward bevel, but the frame bevels inward |
The SizeGroup Mode constants specify the directions in which the size group affects the requested sizes of its component widgets.
gtk.SIZE_GROUP_NONE | The group has no affect |
gtk.SIZE_GROUP_HORIZONTAL | The group affects horizontal requisition |
gtk.SIZE_GROUP_VERTICAL | The group affects vertical requisition |
gtk.SIZE_GROUP_BOTH | The group affects both horizontal and vertical requisition |
The Sort Type constants specify he direction of a sort.
gtk.SORT_ASCENDING | Sorting is in ascending order. |
gtk.SORT_DESCENDING | Sorting is in descending order. |
The SpinButton Update Policy constants specify the update policy for a gtk.SpinButton.
gtk.UPDATE_ALWAYS | When refreshing a gtk.SpinButton, the value is always displayed. |
gtk.UPDATE_IF_VALID | When refreshing a gtk.SpinButton, the value is only displayed if it is valid within the bounds of the spin button's gtk.Adjustment. |
The Spin Type constants specify the step movement of a gtk.SpinButton.
gtk.SPIN_STEP_FORWARD | Spin a gtk.SpinButton forward by the step value of the spin button's gtk.Adjustment. |
gtk.SPIN_STEP_BACKWARD | Spin a gtk.SpinButton backward by the step value of the spin button's gtk.Adjustment. |
gtk.SPIN_PAGE_FORWARD | Spin a gtk.SpinButton forward by the page value of the spin button's gtk.Adjustment. |
gtk.SPIN_PAGE_BACKWARD | Spin a gtk.SpinButton backward by the page value of the spin button's gtk.Adjustment. |
gtk.SPIN_HOME | Set the spin button's value to the minimum possible value specified by its gtk.Adjustment |
gtk.SPIN_END | Set the spin button's value to the maximum possible value specified by its gtk.Adjustment |
gtk.SPIN_USER_DEFINED | The programmer must specify the exact amount to spin the gtk.SpinButton. |
The State Type constants specify the current state of a widget; the state determines how the widget is drawn. The State Type constants are also used to identify different colors in a gtk.Style for drawing, so states can be used for subparts of a widget as well as entire widgets.
gtk.STATE_NORMAL | State during normal operation. |
gtk.STATE_ACTIVE | State of a currently active widget, such as a depressed button. |
gtk.STATE_PRELIGHT | State indicating that the mouse pointer is over the widget and the widget will respond to mouse clicks. |
gtk.STATE_SELECTED | State of a selected item, such the selected row in a list. |
gtk.STATE_INSENSITIVE | State indicating that the widget is unresponsive to user actions. |
The Target Flags constants are a set of bit-flags that specify constraints on the target of a drag operation.
gtk.TARGET_SAME_APP | If this is set, the target will only be selected for drags within a single application. |
gtk.TARGET_SAME_WIDGET | f this is set, the target will only be selected for drags within a single widget. |
The Text Direction constants specify the direction of the text.
gtk.TEXT_DIR_NONE | Text direction not specified. |
gtk.TEXT_DIR_LTR, | Left to right direction. |
gtk.TEXT_DIR_RTL | Right to left direction |
The Text Search Flags constants are a set of bit-flags that specify what types of text are suitable for search matches in a gtk.TextView.
gtk.TEXT_SEARCH_VISIBLE_ONLY | Only visible text can match the search criteria. |
gtk.TEXT_SEARCH_TEXT_ONLY | Both visible and invisible text can match the search criteria. |
The Text Window Type constants specify the gtk.gdk.Window objects that make up a gtk.TextView. See the gtk.TextView.get_window() method for more detail.
gtk.TEXT_WINDOW_WIDGET | The gtk.gdk.Window of the gtk.TextView widget. |
gtk.TEXT_WINDOW_TEXT | The gtk.gdk.Window that contains the text in the gtk.TextView. |
gtk.TEXT_WINDOW_LEFT | The left child gtk.gdk.Window of the gtk.TextView. |
gtk.TEXT_WINDOW_RIGHT | The right child gtk.gdk.Window of the gtk.TextView. |
gtk.TEXT_WINDOW_TOP | The top child gtk.gdk.Window of the gtk.TextView. |
gtk.TEXT_WINDOW_BOTTOM | The bottom child gtk.gdk.Window of the gtk.TextView. |
The TextBuffer Target Info constants specify the info integer for use with the gtk.target_list_add_rich_text_targets() and gtk.target_list_add_text_targets() functions.
gtk.TEXT_BUFFER_TARGET_INFO_BUFFER_CONTENTS | |
gtk.TEXT_BUFFER_TARGET_INFO_RICH_TEXT | |
gtk.TEXT_BUFFER_TARGET_INFO_TEXT |
The Toolbar Space Style constants specify whether a spacer is displayed as a vertical line or space.
gtk.TOOLBAR_SPACE_EMPTY, | Show as an empty space |
gtk.TOOLBAR_SPACE_LINE | Show as a vertical line. |
The Toolbar Style constants specify the appearance of a gtk.Toolbar. Note that setting the toolbar style overrides the user's preferences for the default toolbar style.
gtk.TOOLBAR_ICONS | Buttons display only icons in the toolbar. |
gtk.TOOLBAR_TEXT | Buttons display only text labels in the toolbar. |
gtk.TOOLBAR_BOTH | Buttons display text and icons in the toolbar. |
gtk.TOOLBAR_BOTH_HORIZ | Buttons display icons and text alongside each other, rather than vertically stacked |
The TreeModel Flags constants are a set of bit-flags that specify various properties of a gtk.TreeModel. They are returned by the gtk.TreeModel.get_flags() method, and must be static for the lifetime of the object. A more complete description of gtk.TREE_MODEL_ITERS_PERSIST can be found in the gtk.TreeView reference description.
gtk.TREE_MODEL_ITERS_PERSIST | Iterators survive all signals emitted by the tree. |
gtk.TREE_MODEL_LIST_ONLY | The model is a list only, and never has children |
The TreeView Drop Position constants specify where a dropped row goes.
gtk.TREE_VIEW_DROP_BEFORE | The dropped item goes before the row it's dropped on. |
gtk.TREE_VIEW_DROP_AFTER | The dropped item goes after the row it's dropped on. |
gtk.TREE_VIEW_DROP_INTO_OR_BEFORE | The dropped item becomes a child of the row it's dropped on. Fallback to goes before. |
gtk.TREE_VIEW_DROP_INTO_OR_AFTER | The dropped item becomes a child of the row it's dropped on. Fallback to goes after. |
The TreeView Grid Lines constants specify how grid lines should be applied to a TreeView.
gtk.TREE_VIEW_GRID_LINES_NONE | |
gtk.TREE_VIEW_GRID_LINES_HORIZONTAL | |
gtk.TREE_VIEW_GRID_LINES_VERTICAL | |
gtk.TREE_VIEW_GRID_LINES_BOTH |
The TreeViewColumn Sizing constants specify the sizing method the column uses to determine its width. Please note that gtk.TREE_VIEW_COLUMN_AUTOSIZE are inefficient for large views, and can make columns appear choppy.
gtk.TREE_VIEW_COLUMN_GROW_ONLY | Columns only get bigger in reaction to changes in the model |
gtk.TREE_VIEW_COLUMN_AUTOSIZE | Columns resize to be the optimal size every time the model changes. |
gtk.TREE_VIEW_COLUMN_FIXED | Columns are a fixed numbers of pixels wide. |
The UIManager Item Type constants specify what UI element to create.
gtk.UI_MANAGER_AUTO | Pick the type of the UI element according to context. |
gtk.UI_MANAGER_MENUBAR | Create a menubar. |
gtk.UI_MANAGER_MENU | Create a menu. |
gtk.UI_MANAGER_TOOLBAR | Create a toolbar. |
gtk.UI_MANAGER_PLACEHOLDER | Insert a placeholder. |
gtk.UI_MANAGER_POPUP | Create a popup menu. |
gtk.UI_MANAGER_MENUITEM | Create a menuitem. |
gtk.UI_MANAGER_TOOLITEM | Create a toolitem. |
gtk.UI_MANAGER_SEPARATOR | Create a separator. |
gtk.UI_MANAGER_ACCELERATOR | Install an accelerator. |
The Unit constants specify the
gtk.UNIT_PIXEL | |
gtk.UNIT_POINTS | |
gtk.UNIT_INCH | |
gtk.UNIT_MM |
The Update Type constants specify the update policy of a gtk.Range and gtk.SpinButton.
gtk.UPDATE_CONTINUOUS | Update the display continuously as the pointer is moved. |
gtk.UPDATE_DISCONTINUOUS | Update the display at intervals while the pointer is being moved. |
gtk.UPDATE_DELAYED | Update the display after the pointer has finished moving. |
The Version constants specify the versions of GTK+ and PyGTK as a 3-tuple containing the major, minor and patch release numbers.
gtk.gtk_version | A 3-tuple containing the GTK+ (major, minor, patch) release numbers. |
gtk.pygtk_version | A 3-tuple containing the PyGTK (major, minor, patch) release numbers. |
The Widget Flags constants are a set of bit-flags that specify certain properties of the widget.
gtk.TOPLEVEL | Widgets without a real parent, as there are gtk.Window and gtk.Menu objects that have this flag set throughout their lifetime. Toplevel widgets always contain their own gtk.gdk.Window. |
gtk.NO_WINDOW | Indicative for a widget that does not provide its own gtk.gdk.Window. Visible action (e.g. drawing) is performed on the parent's gtk.gdk.Window. |
gtk.REALIZED | Set by the gtk.Widget.realize() method , unset by the gtk.Widget.unrealize() method. A realized widget has an associated gtk.gdk.Window. |
gtk.MAPPED | Set by the gtk.Widget.map() method, unset by the gtk.Widget.unmap() method. Only realized widgets can be mapped. It means that the gtk.Window.show() method has been called on the widgets window(s). |
gtk.VISIBLE | Set by the gtk.Widget.show() method, unset by the gtk.Widget.hide() method. Implies that a widget will be mapped as soon as its parent is mapped. |
gtk.SENSITIVE | Set and unset by the gtk.Widget.set_sensitive() method. The sensitivity of a widget determines whether it will receive certain events (e.g. button or key presses). One premise for the widgets sensitivity is to have this flag set. |
gtk.PARENT_SENSITIVE | Set and unset by the gtk.Widget.set_sensitive() method operations on the parents of the widget. This is the second premise for the widgets sensitivity. Once it has gtk.SENSITIVE and gtk.PARENT_SENSITIVE set, its state is effectively sensitive. |
gtk.CAN_FOCUS | Determines if a widget is able to handle focus grabs. |
gtk.HAS_FOCUS | Set by the gtk.Widget.grab_focus() method for widgets that also have gtk.CAN_FOCUS set. The flag will be unset once another widget grabs the focus. |
gtk.CAN_DEFAULT | The widget is allowed to receive the default action via the gtk.Widget.grab_default() method. |
gtk.HAS_DEFAULT | The widget currently is receiving the default action. |
gtk.HAS_GRAB | Set by the gtk.Widget.grab_add() method, unset by the gtk.Widget.grab_remove() method. It means that the widget is in the grab_widgets stack, and will be the preferred one for receiving events other than ones of cosmetic value. |
gtk.RC_STYLE | Indicates that the widgets style has been looked up through the rc mechanism. It does not imply that the widget actually had a style defined through the rc mechanism. |
gtk.COMPOSITE_CHILD | Indicates that the widget is a composite child of its parent; see the gtk.widget_push_composite_child() and gtk.widget_pop_composite_child() functions. |
gtk.NO_REPARENT | Unused. |
gtk.APP_PAINTABLE | Set and unset by the gtk.Widget.set_app_paintable() method. Must be set on widgets whose window the application directly draws on, in order to keep PyGTK and GTK+ from overwriting the drawn stuff. |
gtk.RECEIVES_DEFAULT | The widget when focused will receive the default action and have gtk.HAS_DEFAULT set even if there is a different widget set as default. |
gtk.DOUBLE_BUFFERED | Set and unset by the gtk.Widget.set_double_buffered() method. Indicates that exposes done on the widget should be double-buffered. |
gtk.NO_SHOW_ALL | If TRUE, the show_all() and hide_all() methods do not affect the widget. |
The Widget Help Type constants specify the help type of the widget.
gtk.WIDGET_HELP_TOOLTIP | Tooltip help. |
gtk.WIDGET_HELP_WHATS_THIS | What's this help. |
The Window Position constants specify hints for initial window placement.
gtk.WIN_POS_NONE | No influence is made on placement. |
gtk.WIN_POS_CENTER | Windows should be placed in the center of the screen. |
gtk.WIN_POS_MOUSE | Windows should be placed at the current mouse position. |
gtk.WIN_POS_CENTER_ALWAYS | Keep window centered as it changes size, etc. |
gtk.WIN_POS_CENTER_ON_PARENT | Center the window on its transient parent (see the gtk.Window.set_transient_for()) method. |
The Window Type constants specify the type of a gtk.Window. Most things you'd consider a "window" should have type gtk.WINDOW_TOPLEVEL; windows with this type are managed by the window manager and have a frame by default (call the set_decorated() method to toggle the frame). Windows with type gtk.WINDOW_POPUP are ignored by the window manager; window manager keybindings won't work on them, the window manager won't decorate the window with a frame, many GTK+ features that rely on the window manager will not work (e.g. resize grips and maximization/minimization). gtk.WINDOW_POPUP is used to implement widgets such as gtk.Menu or tooltips that you normally don't think of as windows per se. Nearly all windows should be gtk.WINDOW_TOPLEVEL. In particular, do not use gtk.WINDOW_POPUP just to turn off the window borders; use the gtk.Window.set_decorated() method for that.
gtk.WINDOW_TOPLEVEL | A regular window, such as a dialog. |
gtk.WINDOW_POPUP | A special window such as a tooltip. |
The Wrap Mode constants specify the type of line wrapping in a gtk.TextView.
gtk.WRAP_NONE | Do not wrap lines - just make the text area wider |
gtk.WRAP_CHAR | Wrap text, breaking lines anywhere the cursor can appear (usually between characters) |
gtk.WRAP_WORD | Wrap text, breaking lines in between words |
gtk.WRAP_WORD_CHAR | Wrap text, breaking lines in between words, or if that is not enough, also between graphemes. |