Crea Modifica FrontPage Indici Cerca Ultime modifiche History RSS Login

class Gtk::Settings

Sharing settings between applications.

Object Hierarchy

Object
- GLib::Instantiatable
  - GLib::Object
    - Gtk::Settings

Class Methods

Gtk::Settings.default

Gets the Gtk::Settings object for the default GDK screen, creating it if necessary. See Gtk::Settings.get_for_screen.

Returns: A Gtk::Settings object. If there is no default screen, then returns nil

Gtk::Settings.get_for_screen(screen)

Gets the Gtk::Settings object for screen, creating it if necessary. Since 2.2

screen: A Gdk::Screen
Returns: A Gtk::Settings object

Gtk::Settings.install_property(pspec)

Install a new property.

pspec: a subclass of GLib::Param? for the new property
Returns: self

Gtk::Settings.install_property(pspec){|pspec, str| ... }

Install a new property with a block of property parser. The block have to return a new property value, or nil if you can't convert the RC string

{|pspec, str| ... }: a block of property parser. it parses str and returns new value or nil.
- pspec: A subclass of GLib::Param?
- str: RC string

Gtk::Settings.rc_property_parse_color(pspec, color_str)

Parses a color given either by its name or in the form { red, green, blue } where red, green and blue are integers between 0 and 65535 or floating-point numbers between 0 and 1.

pspec: A subclass of GLib::Param? (Usually use GLib::Param::Int?)
color_str: A color string such as "{444444, 555555, 65535}"
Returns: A Gdk::Color

Gtk::Settings.rc_property_parse_enum(pspec, enum_str)

The enumeration value can be specified by its name, its nickname or its numeric value. For consistency with flags parsing, the value may be surrounded by parentheses.

pspec: A subclass of GLib::Param? (Usually GLib::Param::Enum?)
enum_str: A name of GLib::Enum? value such as "center" of GtkAcnhorType
Returns: A GLib::Enum?

Gtk::Settings.rc_property_parse_flags(pspec, flags_str)

Flags can be specified by their name, their nickname or numerically. Multiple flags can be specified in the form "( flag1 | flag2 | ... )".

pspec: A subclass of GLib::Param? (Usually GLib::Param::Flags?)
flags_str: A name of GLib::Flags? value such as "(scroll-mask|structure-mask)" of GdkEventMask
Returns: A GLib::Flags?

Gtk::Settings.rc_property_parse_requisition(pspec, req_str)

Parses a requisition in the form "{ width, height }" for integers width and height.

pspec: A subclass of GLib::Param? (Usually GLib::Param::Int?)
req_str: A requisition string such as "{10, 20}"
Returns: [width, height]

Gtk::Settings.rc_property_parse_border(pspec, prop_str)

Parses borders in the form "{ left, right, top, bottom }" for integers left, right, top and bottom.

pspec: A subclass of GLib::Param? (Usually GLib::Param::Int?)
prop_str: A border string such as "{0, 100, 10, 200}"
Returns: A Gtk::Border

Instance Methods

set_property_value(name, value, origin)

Sets the property value.

name: The name of propery
value: The value of the property. Valid types are Integer, Float or String
origin: origin should be something like "filename:linenumber" for rc files, or e.g. "XProperty" for other sources
Returns: self

gtk_alternative_button_order?

Gets the value whether buttons in dialogs should use the alternative button order or not.

Returns: true if buttons in dialogs should use the alternative button order

gtk_alternative_button_order=(setting)

Sets the value whether buttons in dialogs should use the alternative button order or not.

setting: true if buttons in dialogs should use the alternative button order
Returns: setting

set_gtk_alternative_button_order(setting)

Same as Gtk::Settings#gtk_alternative_button_order=.

setting: true if buttons in dialogs should use the alternative button order
Returns: self

gtk_button_images?

Gets the value whether stock icons should be shown in buttons or not.

Returns: true if stock icons should be shown in buttons

gtk_button_images=(setting)

Sets the value whether stock icons should be shown in buttons or not.

setting: true if stock icons should be shown in buttons
Returns: setting

set_gtk_button_images(setting)

Same as Gtk::Settings#gtk_button_images=.

setting: true if stock icons should be shown in buttons
Returns: self

gtk_can_change_accels?

Gets the value whether menu accelerators can be changed by pressing a key over the menu item or not.

Returns: true if menu accelerators can be changed by pressing a key over the menu item

gtk_can_change_accels=(setting)

Sets the value whether menu accelerators can be changed by pressing a key over the menu item or not.

setting: true if menu accelerators can be changed by pressing a key over the menu item
Returns: gtk_can_change_accels

set_gtk_can_change_accels(setting)

Same as Gtk::Settings#gtk_can_change_accels=.

setting: true if menu accelerators can be changed by pressing a key over the menu item
Returns: self

gtk_color_palette

Gets the Palette to use in the color selector.

Returns: Palette to use in the color selector

gtk_color_palette=(palette)

Sets the Palette to use in the color selector. The Palette is a String of "color1:color2:..." format.

palette: Palette String to use in the color selector such as "black:white:..."
Returns: palette

set_gtk_color_palette(palette)

Same as Gtk::Settings#gtk_color_palette=.

palette: Palette String to use in the color selector such as "black:white:..."
Returns: self

gtk_cursor_blink?

Gets the value whether the cursor should blink or not.

Returns: true if the cursor should blink

gtk_cursor_blink=(setting)

Sets the value whether the cursor should blink or not.

setting: true if the cursor should blink
Returns: gtk_cursor_blink

set_gtk_cursor_blink(setting)

Same as Gtk::Settings#gtk_cursor_blink=.

setting: true if the cursor should blink
Returns: self

gtk_cursor_blink_time

Gets the length of the cursor blink cycle, in milleseconds.

Returns: Length of the cursor blink cycle, in milleseconds

gtk_cursor_blink_time=(time)

Sets the length of the cursor blink cycle, in milleseconds.

time: Length of the cursor blink cycle, in milleseconds
Returns: gtk_cursor_blink_time

set_gtk_cursor_blink_time(time)

Same as Gtk::Settings#gtk_cursor_blink_time=.

time: Length of the cursor blink cycle, in milleseconds
Returns: self

gtk_dnd_drag_threshold

Gets the number of pixels the cursor can move before dragging.

Returns: Number of pixels the cursor can move before dragging

gtk_dnd_drag_threshold=(val)

Sets the number of pixels the cursor can move before dragging.

val: Number of pixels the cursor can move before dragging (Integer)
Returns: gtk_dnd_drag_threshold

set_gtk_dnd_drag_threshold(val)

Same as Gtk::Settings#gtk_dnd_drag_threshold=.

val: Number of pixels the cursor can move before dragging (Integer)
Returns: self

gtk_double_click_distance

Gets the Maximum distance allowed between two clicks for them to be considered a double click (in pixels).

Returns: Maximum distance allowed between two clicks for them to be considered a double click

gtk_double_click_distance=(val)

Sets the Maximum distance allowed between two clicks for them to be considered a double click (in pixels).

val: Maximum distance allowed between two clicks for them to be considered a double click (Integer)
Returns: gtk_double_click_distance

set_gtk_double_click_distance(val)

Same as Gtk::Settings#gtk_double_click_distance=.

val: Maximum distance allowed between two clicks for them to be considered a double click (Integer)
Returns: self

gtk_double_click_time

Gets the Maximum time allowed between two clicks for them to be considered a double click (in milliseconds).

Returns: Maximum time allowed between two clicks for them to be considered a double click (Integer)

gtk_double_click_time=(val)

Sets the Maximum time allowed between two clicks for them to be considered a double click (in milliseconds).

gtk_double_click_time: Maximum time allowed between two clicks for them to be considered a double click (Integer)
Returns: val

set_gtk_double_click_time(val)

Same as Gtk::Settings#gtk_double_click_time=.

val: Maximum time allowed between two clicks for them to be considered a double click (Integer)
Returns: self

gtk_entry_select_on_focus?

Gets the value whether to select the contents of an entry when it is focused or not.

Returns: true if to select the contents of an entry when it is focused

gtk_entry_select_on_focus=(setting)

Sets the value whether to select the contents of an entry when it is focused or not.

setting: true if to select the contents of an entry when it is focused
Returns: gtk_entry_select_on_focus

set_gtk_entry_select_on_focus(setting)

Same as Gtk::Settings#gtk_entry_select_on_focus=.

setting: true if to select the contents of an entry when it is focused
Returns: self

gtk_font_name

Gets the Name of default font to use.

Returns: Name of default font to use

gtk_font_name=(setting)

Sets the Name of default font to use.

setting: Name of default font to use
Returns: setting

set_gtk_font_name(setting)

Same as Gtk::Settings#gtk_font_name=.

setting: Name of default font to use
Returns: self

gtk_icon_sizes

Gets the List of icon sizes (gtk-menu=16,16;gtk-button=20,20....

Returns: List of icon sizes as a String (gtk-menu=16,16;gtk-button=20,20...

gtk_icon_sizes=(sizes)

Sets the List of icon sizes (gtk-menu=16,16;gtk-button=20,20....

gtk_icon_sizes: List of icon sizes as a String (gtk-menu=16,16;gtk-button=20,20...
Returns: sizes

set_gtk_icon_sizes(sizes)

Same as Gtk::Settings#gtk_icon_sizes=.

sizes: List of icon sizes as a String (gtk-menu=16,16;gtk-button=20,20...
Returns: self

gtk_icon_theme_name

Gets the name of icon theme to use.

Returns: Name of icon theme to use

gtk_icon_theme_name=(name)

Sets the name of icon theme to use.

name: Name of icon theme to use
Returns: name

set_gtk_icon_theme_name(name)

Same as Gtk::Settings#gtk_icon_theme_name=.

name: Name of icon theme to use
Returns: self

gtk_key_theme_name

Gets the name of key theme RC file to load.

Returns: name of key theme RC file to load

gtk_key_theme_name=(name)

Sets the name of key theme RC file to load.

name: Name of key theme RC file to load
Returns: name

set_gtk_key_theme_name(name)

Same as Gtk::Settings#gtk_key_theme_name=.

name: Name of key theme RC file to load
Returns: self

gtk_menu_bar_accel

Gets the keybinding to activate the menu bar.

Returns: Keybinding to activate the menu bar

gtk_menu_bar_accel=(accel)

Sets the keybinding to activate the menu bar.

gtk_menu_bar_accel: Keybinding to activate the menu bar (String)
Returns: accel

set_gtk_menu_bar_accel(accel)

Same as Gtk::Settings#gtk_menu_bar_accel=.

accel: Keybinding to activate the menu bar (String)
Returns: self

gtk_menu_bar_popup_delay

Gets the delay before the submenus of a menu bar appear.

Returns: Delay before the submenus of a menu bar appear

gtk_menu_bar_popup_delay=(delay)

Sets the Delay before the submenus of a menu bar appear.

delay: Delay before the submenus of a menu bar appear (Integer)
Returns: delay

set_gtk_menu_bar_popup_delay(delay)

Same as Gtk::Settings#gtk_menu_bar_popup_delay=.

delay: Delay before the submenus of a menu bar appear (Integer)
Returns: self

gtk_menu_images?

Gets the value whether images should be shown in menus or not.

Returns: true if images should be shown in menus

gtk_menu_images=(setting)

Sets the value whether images should be shown in menus or not.

setting: true if images should be shown in menus
Returns: setting

set_gtk_menu_images(setting)

Same as Gtk::Settings#gtk_menu_images=.

setting: true if images should be shown in menus
Returns: self

gtk_menu_popdown_delay

Gets the time before hiding a submenu when the pointer is moving towards the submenu.

Returns: The time before hiding a submenu when the pointer is moving towards the submenu

gtk_menu_popdown_delay=(delay)

Sets the time before hiding a submenu when the pointer is moving towards the submenu.

delay: The time before hiding a submenu when the pointer is moving towards the submenu (Integer)
Returns: delay

set_gtk_menu_popdown_delay(delay)

Same as Gtk::Settings#gtk_menu_popdown_delay=.

delay: The time before hiding a submenu when the pointer is moving towards the submenu (Integer)
Returns: self

gtk_menu_popup_delay

Gets the Minimum time the pointer must stay over a menu item before the submenu appear.

Returns: Minimum time the pointer must stay over a menu item before the submenu appear

gtk_menu_popup_delay=(delay)

Sets the Minimum time the pointer must stay over a menu item before the submenu appear.

delay: Minimum time the pointer must stay over a menu item before the submenu appear (Integer)
Returns: delay

set_gtk_menu_popup_delay(delay)

Same as Gtk::Settings#gtk_menu_popup_delay=.

delay: Minimum time the pointer must stay over a menu item before the submenu appear (Integer)
Returns: self

gtk_modules

Gets the List of currently active GTK modules as String.

Returns: List of currently active GTK modules as String

gtk_modules=(gtk_modules)

Sets the List of currently active GTK modules as String.

gtk_modules: List of currently active GTK modules as String
Returns: gtk_modules

set_gtk_modules(gtk_modules)

Same as Gtk::Settings#gtk_modules=.

gtk_modules: List of currently active GTK modules as String
Returns: self

gtk_split_cursor?

Gets the value whether two cursors should be displayed for mixed left-to-right and right-to-left text or not.

Returns: true if two cursors should be displayed for mixed left-to-right and right-to-left text

gtk_split_cursor=(setting)

Sets the value whether two cursors should be displayed for mixed left-to-right and right-to-left text or not.

setting: true if two cursors should be displayed for mixed left-to-right and right-to-left text
Returns: setting

set_gtk_split_cursor(setting)

Same as Gtk::Settings#gtk_split_cursor=.

setting: true if two cursors should be displayed for mixed left-to-right and right-to-left text
Returns: self

gtk_theme_name

Gets the Name of theme RC file to load.

Returns: Name of theme RC file to load

gtk_theme_name=(name)

Sets the Name of theme RC file to load.

name: Name of theme RC file to load
Returns: name

set_gtk_theme_name(name)

Same as Gtk::Settings#gtk_theme_name=.

name: Name of theme RC file to load
Returns: self

gtk_toolbar_icon_size

Gets the Size of icons in default toolbars.

Returns: Size of icons in default toolbars

gtk_toolbar_icon_size=(icon_size)

Sets the Size of icons in default toolbars.

icon_size: Size of icons in default toolbars (Gtk::IconSize)
Returns: icon_size

set_gtk_toolbar_icon_size(icon_size)

Same as Gtk::Settings#gtk_toolbar_icon_size=.

icon_size: Size of icons in default toolbars (Gtk::IconSize)
Returns: self

gtk_toolbar_style

Gets the value whether default toolbars have text only, text and icons, icons only, etc. or not.

Returns: true if default toolbars have text only, text and icons, icons only, etc.

gtk_toolbar_style=(style)

Sets the value whether default toolbars have text only, text and icons, icons only, etc. or not.

style: true if default toolbars have text only, text and icons, icons only, etc. (GtkToolbarStyle)
Returns: style

set_gtk_toolbar_style(style)

Same as Gtk::Settings#gtk_toolbar_style=.

style: true if default toolbars have text only, text and icons, icons only, etc.(GtkToolbarStyle)
Returns: self

gtk_xft_antialias

Gets the value whether to antialias Xft fonts; 0 = no, 1 = yes, -1 = default or not.

Returns: 0 = no, 1 = yes, -1 = default

gtk_xft_antialias=(val)

Sets the value whether to antialias Xft fonts; 0 = no, 1 = yes, -1 = default or not.

val: An Integer (0 = no, 1 = yes, -1 = default)
Returns: val

set_gtk_xft_antialias(val)

Same as Gtk::Settings#gtk_xft_antialias=.

val: An Integer (0 = no, 1 = yes, -1 = default)
Returns: self

gtk_xft_dpi

Gets the Resolution for Xft, in 1024 * dots/inch. -1 to use default value.

Returns: Resolution for Xft as Integer

gtk_xft_dpi=(dpi)

Sets the Resolution for Xft, in 1024 * dots/inch. -1 to use default value.

dpi: Resolution for Xft as Integer
Returns: dpi

set_gtk_xft_dpi(dpi)

Same as Gtk::Settings#gtk_xft_dpi=.

dpi: Resolution for Xft as Integer
Returns: self

gtk_xft_hinting

Gets the value whether to hint Xft fonts; 0 = no, 1 = yes, -1 = default or not.

Returns: 0 = no, 1 = yes, -1 = default

gtk_xft_hinting=(hinting)

Sets the value whether to hint Xft fonts; 0 = no, 1 = yes, -1 = default or not.

hinting: 0 = no, 1 = yes, -1 = default
Returns: hinting

set_gtk_xft_hinting(hinting)

Same as Gtk::Settings#gtk_xft_hinting=.

hinting: 0 = no, 1 = yes, -1 = default
Returns: self

gtk_xft_hintstyle

Gets the degree of hinting to use; none, slight, medium, or full.

Returns: What degree of hinting to use; none, slight, medium, or full

gtk_xft_hintstyle=(hintstyle)

Sets the degree of hinting to use; none, slight, medium, or full.

hintstyle: What degree of hinting to use; none, slight, medium, or full
Returns: hintstyle

set_gtk_xft_hintstyle(hintstyle)

Same as Gtk::Settings#gtk_xft_hintstyle=.

hintstyle: What degree of hinting to use; none, slight, medium, or full
Returns: self

gtk_xft_rgba

Gets the Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr.

Returns: Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr

gtk_xft_rgba=(rgba)

Sets the Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr.

rgba: Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr
Returns: rgba

set_gtk_xft_rgba(rgba)

Same as Gtk::Settings#gtk_xft_rgba=.

rgba: Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr
Returns: self

Properties

gtk-alternative-button-order: true or false (Read/Write)

Whether buttons in dialogs should use the alternative button order

Default value: false

gtk-button-images: true or false (Read/Write)

Whether stock icons should be shown in buttons

Default value: true

gtk-can-change-accels: true or false (Read/Write)

Whether menu accelerators can be changed by pressing a key over the menu item

Default value: false

gtk-color-palette: String (Read/Write)

Palette to use in the color selector

Default value: "black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90"

gtk-cursor-blink: true or false (Read/Write)