Linux Certif

Toute la documentation sur la certification Linux LPI

Gtk2::Widget.3pm

NAME

Gtk2::Widget

HIERARCHY

   Glib::Object
   +----Glib::InitiallyUnowned
        +----Gtk2::Object
             +----Gtk2::Widget
 
 

INTERFACES

   Glib::Object::_Unregistered::AtkImplementorIface
   Gtk2::Buildable
 
 

METHODS

$widget->set_accel_path ($accel_path, $accel_group)

$widget->set_accel_path ($accel_path, $accel_group)

•

$accel_path (string)

•

$accel_group (Gtk2::AccelGroup)

object = $widget->get_accessible

object = $widget->get_accessible

action or undef = $widget->get_action

action or undef = $widget->get_action

Since: gtk+ 2.10

boolean = $widget->activate

boolean = $widget->activate

This function works by emitting an action signal nominated by the various widget subclasses. The signal is normally called "activate", but it doesn't have to be.
Currently if you make a widget subclass in Perl there's no way to nominate a signal to be emitted by "$widget->activate". A signal merely named "activate" is not automatically hooked up.

$widget->add_accelerator ($accel_signal, $accel_group, $accel_key, $accel_mods, $flags)

$widget->add_accelerator ($accel_signal, $accel_group, $accel_key, $accel_mods, $flags)

•

$accel_signal (string)

•

$accel_group (Gtk2::AccelGroup)

•

$accel_key (integer)

•

$accel_mods (Gtk2::Gdk::ModifierType)

•

$flags (Gtk2::AccelFlags)

$widget->add_events ($events)

$widget->add_events ($events)

•

$events (Gtk2::Gdk::EventMask)

$widget->add_mnemonic_label ($label)

$widget->add_mnemonic_label ($label)

•

$label (Gtk2::Widget)

Since: gtk+ 2.4

rectangle = $widget->allocation

rectangle = $widget->allocation

Return the current allocated size and position of $widget within its parent widget. The allocated size is not necessarily the same as the requested size.
The returned rect object points into $widget and can only be used as long as $widget exists.

widget or undef = $widget->get_ancestor ($ancestor_package)

widget or undef = $widget->get_ancestor ($ancestor_package)

•

$ancestor_package (string)

$widget->app_paintable ($boolean)

$widget->app_paintable ($boolean)

boolean = $widget->app_paintable

boolean = $widget->app_paintable

$widget->set_app_paintable ($app_paintable)

$widget->set_app_paintable ($app_paintable)

•

$app_paintable (boolean)

boolean = $widget->can_activate_accel ($signal_id)

boolean = $widget->can_activate_accel ($signal_id)

•

$signal_id (integer)

Since: gtk+ 2.4

$widget->can_default ($boolean)

$widget->can_default ($boolean)

boolean = $widget->can_default

boolean = $widget->can_default

$widget->can_focus ($boolean)

$widget->can_focus ($boolean)

boolean = $widget->can_focus

boolean = $widget->can_focus

boolean = $widget->child_focus ($direction)

boolean = $widget->child_focus ($direction)

•

$direction (Gtk2::DirectionType)

$widget->child_notify ($child_property)

$widget->child_notify ($child_property)

•

$child_property (string)

requisition = $widget->get_child_requisition

requisition = $widget->get_child_requisition

This function is only for use in widget implementations. Obtains "$widget->requisition", unless someone has forced a particular geometry on the widget (e.g., with "set_usize()", in which case it returns that geometry instead of the widget's requisition.
This function differs from size_request() in that it retrieves the last size request value from "$widget->requisition", while "size_request()" actually calls the "size_request" virtual method (that is, emits the ``size-request'' signal) on the $widget to compute the size request and fill in "$widget->requisition", and only then returns "$widget->requisition".
Because this function does not call the "size_request" method, it can only be used when you know that "$widget->requisition" is up-to-date. In general, only container implementations have this information; applications should use "size_request ()".

boolean = $widget->get_child_visible

boolean = $widget->get_child_visible

$widget->set_child_visible ($is_visible)

$widget->set_child_visible ($is_visible)

•

$is_visible (boolean)

(path, path_reversed) = $widget->class_path

(path, path_reversed) = $widget->class_path

clipboard = $widget->get_clipboard ($selection=GDK_SELECTION_CLIPBOARD)

clipboard = $widget->get_clipboard ($selection=GDK_SELECTION_CLIPBOARD)

•

$selection (Gtk2::Gdk::Atom)

Since: gtk+ 2.2

colormap = $widget->get_colormap

colormap = $widget->get_colormap

$widget->set_colormap ($colormap)

$widget->set_colormap ($colormap)

•

$colormap (Gtk2::Gdk::Colormap)

$widget->composite_child ($boolean)

$widget->composite_child ($boolean)

boolean = $widget->composite_child

boolean = $widget->composite_child

string = $widget->get_composite_name

string = $widget->get_composite_name

$widget->set_composite_name ($name)

$widget->set_composite_name ($name)

•

$name (string)

context = $widget->create_pango_context

context = $widget->create_pango_context

layout = $widget->create_pango_layout ($text)

layout = $widget->create_pango_layout ($text)

•

$text (string)

colormap = Gtk2::Widget->get_default_colormap

colormap = $widget->get_default_colormap

colormap = $widget->get_default_colormap

Gtk2::Widget->set_default_colormap ($colormap)

$widget->set_default_colormap ($colormap)

$widget->set_default_colormap ($colormap)

•

$colormap (Gtk2::Gdk::Colormap)

textdirection = Gtk2::Widget->get_default_direction

Gtk2::Widget->set_default_direction ($dir)

•

$dir (Gtk2::TextDirection)

style = Gtk2::Widget->get_default_style

style = $widget->get_default_style

style = $widget->get_default_style

visual = Gtk2::Widget->get_default_visual

visual = $widget->get_default_visual

visual = $widget->get_default_visual

$widget->destroy

$widget->destroy

textdirection = $widget->get_direction

textdirection = $widget->get_direction

$widget->set_direction ($dir)

$widget->set_direction ($dir)

•

$dir (Gtk2::TextDirection)

display = $widget->get_display

display = $widget->get_display

Since: gtk+ 2.2

$widget->double_buffered ($boolean)

$widget->double_buffered ($boolean)

boolean = $widget->double_buffered

boolean = $widget->double_buffered

$widget->set_double_buffered ($double_buffered)

$widget->set_double_buffered ($double_buffered)

•

$double_buffered (boolean)

dragcontext = $widget->drag_begin ($targets, $actions, $button, $event)

dragcontext = $widget->drag_begin ($targets, $actions, $button, $event)

•

$targets (Gtk2::TargetList)

•

$actions (Gtk2::Gdk::DragAction)

•

$button (integer)

•

$event (Gtk2::Gdk::Event)

boolean = $widget->drag_check_threshold ($start_x, $start_y, $current_x, $current_y)

boolean = $widget->drag_check_threshold ($start_x, $start_y, $current_x, $current_y)

•

$start_x (integer)

•

$start_y (integer)

•

$current_x (integer)

•

$current_y (integer)

$widget->drag_dest_add_image_targets

$widget->drag_dest_add_image_targets

Since: gtk+ 2.6

$widget->drag_dest_add_text_targets

$widget->drag_dest_add_text_targets

Since: gtk+ 2.6

$widget->drag_dest_add_uri_targets

$widget->drag_dest_add_uri_targets

Since: gtk+ 2.6

atom = $widget->drag_dest_find_target ($context, $target_list)

atom = $widget->drag_dest_find_target ($context, $target_list)

•

$context (Gtk2::Gdk::DragContext)

•

$target_list (Gtk2::TargetList or undef)

targetlist or undef = $widget->drag_dest_get_target_list

targetlist or undef = $widget->drag_dest_get_target_list

boolean = $widget->drag_dest_get_track_motion

boolean = $widget->drag_dest_get_track_motion

Since: gtk+ 2.10

$widget->drag_dest_set ($flags, $actions, ...)

$widget->drag_dest_set ($flags, $actions, ...)

•

$flags (Gtk2::DestDefaults)

•

$actions (Gtk2::Gdk::DragAction)

•

... (list) of Gtk2::TargetEntry's

$widget->drag_dest_set_proxy ($proxy_window, $protocol, $use_coordinates)

$widget->drag_dest_set_proxy ($proxy_window, $protocol, $use_coordinates)

•

$proxy_window (Gtk2::Gdk::Window)

•

$protocol (Gtk2::Gdk::DragProtocol)

•

$use_coordinates (boolean)

$widget->drag_dest_set_target_list ($target_list)

$widget->drag_dest_set_target_list ($target_list)

•

$target_list (Gtk2::TargetList or undef)

$widget->drag_dest_set_track_motion ($track_motion)

$widget->drag_dest_set_track_motion ($track_motion)

•

$track_motion (boolean)

Since: gtk+ 2.10

$widget->drag_dest_unset

$widget->drag_dest_unset

$widget->drag_get_data ($context, $target, $time_)

$widget->drag_get_data ($context, $target, $time_)

•

$context (Gtk2::Gdk::DragContext)

•

$target (Gtk2::Gdk::Atom)

•

$time_ (unsigned)

$widget->drag_highlight

$widget->drag_highlight

$widget->drag_source_add_image_targets

$widget->drag_source_add_image_targets

Since: gtk+ 2.6

$widget->drag_source_add_text_targets

$widget->drag_source_add_text_targets

Since: gtk+ 2.6

$widget->drag_source_add_uri_targets

$widget->drag_source_add_uri_targets

Since: gtk+ 2.6

targetlist or undef = $widget->drag_source_get_target_list

targetlist or undef = $widget->drag_source_get_target_list

Since: gtk+ 2.4

$widget->drag_source_set ($start_button_mask, $actions, ...)

$widget->drag_source_set ($start_button_mask, $actions, ...)

•

$start_button_mask (Gtk2::Gdk::ModifierType)

•

$actions (Gtk2::Gdk::DragAction)

•

... (list) of Gtk2::TargetEntry's

$widget->drag_source_set_icon ($colormap, $pixmap, $mask)

$widget->drag_source_set_icon ($colormap, $pixmap, $mask)

•

$colormap (Gtk2::Gdk::Colormap or undef)

•

$pixmap (Gtk2::Gdk::Pixmap or undef)

•

$mask (Gtk2::Gdk::Bitmap or undef)

$widget->drag_source_set_icon_name ($icon_name)

$widget->drag_source_set_icon_name ($icon_name)

•

$icon_name (string)

Since: gtk+ 2.8

$widget->drag_source_set_icon_pixbuf ($pixbuf)

$widget->drag_source_set_icon_pixbuf ($pixbuf)

•

$pixbuf (Gtk2::Gdk::Pixbuf or undef)

$widget->drag_source_set_icon_stock ($stock_id)

$widget->drag_source_set_icon_stock ($stock_id)

•

$stock_id (string)

$widget->drag_source_set_target_list ($target_list)

$widget->drag_source_set_target_list ($target_list)

•

$target_list (Gtk2::TargetList or undef)

Since: gtk+ 2.4

$widget->drag_source_unset

$widget->drag_source_unset

$widget->drag_unhighlight

$widget->drag_unhighlight

$widget->drawable ($boolean)

$widget->drawable ($boolean)

boolean = $widget->drawable

boolean = $widget->drawable

$widget->ensure_style

$widget->ensure_style

$widget->error_bell

$widget->error_bell

Since: gtk+ 2.12

boolean = $widget->event ($event)

boolean = $widget->event ($event)

•

$event (Gtk2::Gdk::Event)

This rarely-used function emits an event signal on $widget. Don't use this to synthesize events; use "Gtk2->main_do_event" instead. Don't synthesize expose events; use "$gdkwindow->invalidate_rect" instead. Basically, the main use for this in gtk2-perl will be to pass motion notify events to rulers from other widgets.

eventmask = $widget->get_events

eventmask = $widget->get_events

$widget->set_events ($events)

$widget->set_events ($events)

•

$events (Gtk2::Gdk::EventMask)

extensionmode = $widget->get_extension_events

extensionmode = $widget->get_extension_events

$widget->set_extension_events ($mode)

$widget->set_extension_events ($mode)

•

$mode (Gtk2::Gdk::ExtensionMode)

widgetflags = $widget->flags

widgetflags = $widget->flags

widgetflags = $widget->get_flags

widgetflags = $widget->get_flags

$widget->set_flags ($flags)

$widget->set_flags ($flags)

•

$flags (Gtk2::WidgetFlags)

$widget->freeze_child_notify

$widget->freeze_child_notify

$widget->grab_default

$widget->grab_default

$widget->grab_focus

$widget->grab_focus

$widget->has_default ($boolean)

$widget->has_default ($boolean)

boolean = $widget->has_default

boolean = $widget->has_default

$widget->has_focus ($boolean)

$widget->has_focus ($boolean)

boolean = $widget->has_focus

boolean = $widget->has_focus

$widget->has_grab ($boolean)

$widget->has_grab ($boolean)

boolean = $widget->has_grab

boolean = $widget->has_grab

boolean = $widget->has_screen

boolean = $widget->has_screen

Since: gtk+ 2.2

boolean = $widget->get_has_tooltip

boolean = $widget->get_has_tooltip

Since: gtk+ 2.12

$widget->set_has_tooltip ($has_tooltip)

$widget->set_has_tooltip ($has_tooltip)

•

$has_tooltip (boolean)

Since: gtk+ 2.12

$widget->hide

$widget->hide

$widget->hide_all

$widget->hide_all

boolean = Gtk2::Widget::hide_on_delete ($widget, ...)

•

$widget (Gtk2::Widget)

•

... (list) other arguments ignored (event etc)

This is a helper function intended to be used as the callback for the "delete-event" signal:

   $wiget->signal_connect (
     delete_event => \&Gtk2::Widget::hide_on_delete);
 
 

$widget->input_shape_combine_mask ($shape_mask, $offset_x, $offset_y)

$widget->input_shape_combine_mask ($shape_mask, $offset_x, $offset_y)

•

$shape_mask (Gtk2::Gdk::Bitmap or undef)

•

$offset_x (integer)

•

$offset_y (integer)

Since: gtk+ 2.10

rectangle = $widget->intersect ($area)

rectangle = $widget->intersect ($area)

•

$area (Gtk2::Gdk::Rectangle)

Returns undef if $widget and $area do not intersect.

boolean = $widget->is_ancestor ($ancestor)

boolean = $widget->is_ancestor ($ancestor)

•

$ancestor (Gtk2::Widget)

boolean = $widget->is_focus

boolean = $widget->is_focus

$widget->is_sensitive ($boolean)

$widget->is_sensitive ($boolean)

boolean = $widget->is_sensitive

boolean = $widget->is_sensitive

boolean = $widget->keynav_failed ($direction)

boolean = $widget->keynav_failed ($direction)

•

$direction (Gtk2::DirectionType)

Since: gtk+ 2.12

list = $widget->list_mnemonic_labels

list = $widget->list_mnemonic_labels

Since: gtk+ 2.4

$widget->map

$widget->map

$widget->mapped ($boolean)

$widget->mapped ($boolean)

boolean = $widget->mapped

boolean = $widget->mapped

boolean = $widget->mnemonic_activate ($group_cycling)

boolean = $widget->mnemonic_activate ($group_cycling)

•

$group_cycling (boolean)

rcstyle = $widget->get_modifier_style

rcstyle = $widget->get_modifier_style

$widget->modify_base ($state, $color)

$widget->modify_base ($state, $color)

•

$state (Gtk2::StateType)

•

$color (Gtk2::Gdk::Color or undef)

$widget->modify_bg ($state, $color)

$widget->modify_bg ($state, $color)

•

$state (Gtk2::StateType)

•

$color (Gtk2::Gdk::Color or undef)

$widget->modify_cursor ($primary, $secondary)

$widget->modify_cursor ($primary, $secondary)

•

$primary (Gtk2::Gdk::Color)

•

$secondary (Gtk2::Gdk::Color)

Since: gtk+ 2.12

$widget->modify_fg ($state, $color)

$widget->modify_fg ($state, $color)

•

$state (Gtk2::StateType)

•

$color (Gtk2::Gdk::Color or undef)

$widget->modify_font ($font_desc)

$widget->modify_font ($font_desc)

•

$font_desc (Gtk2::Pango::FontDescription or undef)

$widget->modify_style ($style)

$widget->modify_style ($style)

•

$style (Gtk2::RcStyle)

$widget->modify_text ($state, $color)

$widget->modify_text ($state, $color)

•

$state (Gtk2::StateType)

•

$color (Gtk2::Gdk::Color or undef)

string = $widget->get_name

string = $widget->get_name

$widget->set_name ($name)

$widget->set_name ($name)

•

$name (string)

boolean = $widget->get_no_show_all

boolean = $widget->get_no_show_all

Since: gtk+ 2.4

$widget->set_no_show_all ($no_show_all)

$widget->set_no_show_all ($no_show_all)

•

$no_show_all (boolean)

Since: gtk+ 2.4

$widget->no_window ($boolean)

$widget->no_window ($boolean)

boolean = $widget->no_window

boolean = $widget->no_window

context = $widget->get_pango_context

context = $widget->get_pango_context

widget or undef = $widget->parent

widget or undef = $widget->parent

widget or undef = $widget->get_parent

widget or undef = $widget->get_parent

$widget->parent_sensitive ($boolean)

$widget->parent_sensitive ($boolean)

boolean = $widget->parent_sensitive

boolean = $widget->parent_sensitive

$widget->set_parent ($parent)

$widget->set_parent ($parent)

•

$parent (Gtk2::Widget)

window = $widget->get_parent_window

window = $widget->get_parent_window

$widget->set_parent_window ($parent_window)

$widget->set_parent_window ($parent_window)

•

$parent_window (Gtk2::Gdk::Window)

(path, path_reversed) = $widget->path

(path, path_reversed) = $widget->path

(x, y) = $widget->get_pointer

(x, y) = $widget->get_pointer

Gtk2::Widget->pop_colormap (cmap)

$widget->pop_colormap (cmap)

$widget->pop_colormap (cmap)

Gtk2::Widget->pop_composite_child

$widget->pop_composite_child

$widget->pop_composite_child

$widget->propagate_event ($event)

$widget->propagate_event ($event)

•

$event (Gtk2::Gdk::Event)

From gtk+'s API documentation:
You most likely don't want to use any of these functions; synthesizing events is rarely needed. Consider asking on the mailing list for better ways to achieve your goals. For example, use Gtk2::Gdk::invalidate_rect or Gtk2::Widget::queue_draw instead of making up expose events.

Gtk2::Widget->push_colormap (cmap)

$widget->push_colormap (cmap)

$widget->push_colormap (cmap)

•

$cmap (Gtk2::Gdk::Colormap)

Gtk2::Widget->push_composite_child

$widget->push_composite_child

$widget->push_composite_child

$widget->queue_draw

$widget->queue_draw

$widget->queue_draw_area ($x, $y, $width, $height)

$widget->queue_draw_area ($x, $y, $width, $height)

•

$x (integer)

•

$y (integer)

•

$width (integer)

•

$height (integer)

$widget->queue_resize

$widget->queue_resize

$widget->queue_resize_no_redraw

$widget->queue_resize_no_redraw

Since: gtk+ 2.4

$widget->rc_style ($boolean)

$widget->rc_style ($boolean)

boolean = $widget->rc_style

boolean = $widget->rc_style

$widget->realize

$widget->realize

$widget->realized ($boolean)

$widget->realized ($boolean)

boolean = $widget->realized

boolean = $widget->realized

$widget->receives_default ($boolean)

$widget->receives_default ($boolean)

boolean = $widget->receives_default

boolean = $widget->receives_default

$widget->set_redraw_on_allocate ($redraw_on_allocate)

$widget->set_redraw_on_allocate ($redraw_on_allocate)

•

$redraw_on_allocate (boolean)

region = $widget->region_intersect ($region)

region = $widget->region_intersect ($region)

•

$region (Gtk2::Gdk::Region)

boolean = $widget->remove_accelerator ($accel_group, $accel_key, $accel_mods)

boolean = $widget->remove_accelerator ($accel_group, $accel_key, $accel_mods)

•

$accel_group (Gtk2::AccelGroup)

•

$accel_key (integer)

•

$accel_mods (Gtk2::Gdk::ModifierType)

$widget->remove_mnemonic_label ($label)

$widget->remove_mnemonic_label ($label)

•

$label (Gtk2::Widget)

Since: gtk+ 2.4

pixbuf = $widget->render_icon ($stock_id, $size, $detail=undef)

pixbuf = $widget->render_icon ($stock_id, $size, $detail=undef)

•

$stock_id (string)

•

$size (Gtk2::IconSize)

•

$detail (string)

$widget->reparent ($new_parent)

$widget->reparent ($new_parent)

•

$new_parent (Gtk2::Widget)

requisition = $widget->requisition

requisition = $widget->requisition

Return the currently desired width and height of $widget. Basically this is the result from the last "size_request" call on $widget, and therefore may not be up-to-date if $widget has asked for a resize but its container parent has not yet called "size_request".
The returned requisition object points into $widget and can only be used as long as $widget exists.

$widget->reset_rc_styles

$widget->reset_rc_styles

$widget->reset_shapes

$widget->reset_shapes

window = $widget->get_root_window

window = $widget->get_root_window

Since: gtk+ 2.2

statetype = $widget->saved_state

statetype = $widget->saved_state

screen = $widget->get_screen

screen = $widget->get_screen

Since: gtk+ 2.2

boolean = $widget->set_scroll_adjustments ($hadjustment, $vadjustment)

boolean = $widget->set_scroll_adjustments ($hadjustment, $vadjustment)

•

$hadjustment (Gtk2::Adjustment or undef)

•

$vadjustment (Gtk2::Adjustment or undef)

This function works by emitting a setter signal nominated by the various widget types which have ``native'' scrolling. The signal is normally called "set-scroll-adjustments", but it doesn't have to be.
If you make a widget subclass in Perl and create a signal in it called "set-scroll-adjustments" taking two Gtk2::Adjustment parameters then the subclassing automatically hooks that up to be emitted by "$widget->set_scroll_adjustments". (Your ``class closure'' default handler code should then store the adjustment objects somewhere.)

$widget->selection_add_target ($selection, $target, $info)

$widget->selection_add_target ($selection, $target, $info)

•

$selection (Gtk2::Gdk::Atom)

•

$target (Gtk2::Gdk::Atom)

•

$info (integer)

$widget->selection_add_targets ($selection, ...)

$widget->selection_add_targets ($selection, ...)

•

$selection (Gtk2::Gdk::Atom)

•

... (list) of Gtk2::TargetEntry's

$widget->selection_clear_targets ($selection)

$widget->selection_clear_targets ($selection)

•

$selection (Gtk2::Gdk::Atom)

boolean = $widget->selection_convert ($selection, $target, $time_)

boolean = $widget->selection_convert ($selection, $target, $time_)

•

$selection (Gtk2::Gdk::Atom)

•

$target (Gtk2::Gdk::Atom)

•

$time_ (unsigned)

$widget->selection_remove_all

$widget->selection_remove_all

$widget->sensitive ($boolean)

$widget->sensitive ($boolean)

boolean = $widget->sensitive

boolean = $widget->sensitive

$widget->set_sensitive ($sensitive)

$widget->set_sensitive ($sensitive)

•

$sensitive (boolean)

settings = $widget->get_settings

settings = $widget->get_settings

$widget->shape_combine_mask ($shape_mask, $offset_x, $offset_y)

$widget->shape_combine_mask ($shape_mask, $offset_x, $offset_y)

•

$shape_mask (Gtk2::Gdk::Bitmap)

•

$offset_x (integer)

•

$offset_y (integer)

$widget->show

$widget->show

$widget->show_all

$widget->show_all

$widget->show_now

$widget->show_now

$widget->size_allocate ($allocation)

$widget->size_allocate ($allocation)

•

$allocation (Gtk2::Gdk::Rectangle)

requisition = $widget->size_request

requisition = $widget->size_request

This function is typically used when implementing a GtkContainer subclass. Obtains the preferred size of a widget. The container uses this information to arrange its child widgets and decide what size allocations to give them with size_allocate ().
You can also call this function from an application, with some caveats. Most notably, getting a size request requires the widget to be associated with a screen, because font information may be needed. Multihead-aware applications should keep this in mind.
Also remember that the size request is not necessarily the size a widget will actually be allocated.
See also get_child_requisition ()

(width, height) = $widget->get_size_request

(width, height) = $widget->get_size_request

Gets the size request that was explicitly set for the widget using "set_size_request()". A value of -1 for width or height indicates that the dimension has not been explicitly set and the natural requisition of the widget will be used instead. See set_size_request(). To get the size a widget will actually use, call size_request() instead of this function.

$widget->set_size_request ($width=-1, $height=-1)

$widget->set_size_request ($width=-1, $height=-1)

•

$width (integer)

•

$height (integer)

pixmap or undef = $widget->get_snapshot ($clip_rect=undef)

pixmap or undef = $widget->get_snapshot ($clip_rect=undef)

•

$clip_rect (Gtk2::Gdk::Rectangle or undef)

Since: gtk+ 2.14

statetype = $widget->state

statetype = $widget->state

$widget->set_state ($state)

$widget->set_state ($state)

•

$state (Gtk2::StateType)

style = $widget->style

style = $widget->style

style = $widget->get_style

style = $widget->get_style

list = $widget->style_get ($first_property_name, ...)

list = $widget->style_get ($first_property_name, ...)

•

$first_property_name (string)

•

... (list) 0 or more additional property names

Returns the values of the requested style properties.
Since: gtk+ 2.2

list = $widget->style_get_property ($first_property_name, ...)

list = $widget->style_get_property ($first_property_name, ...)

•

$first_property_name (string)

•

... (list) 0 or more additional property names

An alias for style_get.
Since: gtk+ 2.2

$widget->set_style ($style)

$widget->set_style ($style)

•

$style (Gtk2::Style or undef)

$widget->thaw_child_notify

$widget->thaw_child_notify

string = $widget->get_tooltip_markup

string = $widget->get_tooltip_markup

Since: gtk+ 2.12

$widget->set_tooltip_markup ($markup)

$widget->set_tooltip_markup ($markup)

•

$markup (string or undef)

Since: gtk+ 2.12

string = $widget->get_tooltip_text

string = $widget->get_tooltip_text

Since: gtk+ 2.12

$widget->set_tooltip_text ($text)

$widget->set_tooltip_text ($text)

•

$text (string or undef)

Since: gtk+ 2.12

window or undef = $widget->get_tooltip_window

window or undef = $widget->get_tooltip_window

Since: gtk+ 2.12

$widget->set_tooltip_window ($custom_window)

$widget->set_tooltip_window ($custom_window)

•

$custom_window (Gtk2::Window or undef)

Since: gtk+ 2.12

$widget->toplevel ($value)

$widget->toplevel ($value)

boolean = $widget->toplevel

boolean = $widget->toplevel

widget or undef = $widget->get_toplevel

widget or undef = $widget->get_toplevel

(dst_x, dst_y) = $src_widget->translate_coordinates ($dest_widget, $src_x, $src_y)

(dst_x, dst_y) = $src_widget->translate_coordinates ($dest_widget, $src_x, $src_y)

•

$dest_widget (Gtk2::Widget)

•

$src_x (integer)

•

$src_y (integer)

Returns an empty list if either widget is not realized or if they do not share a common ancestor.

$widget->trigger_tooltip_query

$widget->trigger_tooltip_query

Since: gtk+ 2.12

$widget->unmap

$widget->unmap

$widget->unparent

$widget->unparent

$widget->unrealize

$widget->unrealize

$widget->unset_flags ($flags)

$widget->unset_flags ($flags)

•

$flags (Gtk2::WidgetFlags)

$widget->visible ($boolean)

$widget->visible ($boolean)

boolean = $widget->visible

boolean = $widget->visible

visual = $widget->get_visual

visual = $widget->get_visual

window or undef = $widget->window ($new=undef)

window or undef = $widget->window ($new=undef)

•

$new (Gtk2::Gdk::Window or undef)

PROPERTIES

'app-paintable' (boolean : readable / writable / private)

Whether the application will paint directly on the widget

'can-default' (boolean : readable / writable / private)

Whether the widget can be the default widget

'can-focus' (boolean : readable / writable / private)

Whether the widget can accept the input focus

'composite-child' (boolean : readable / private)

Whether the widget is part of a composite widget

'events' (Gtk2::Gdk::EventMask : readable / writable / private)

The event mask that decides what kind of GdkEvents this widget gets

'extension-events' (Gtk2::Gdk::ExtensionMode : readable / writable / private)

The mask that decides what kind of extension events this widget gets

'has-default' (boolean : readable / writable / private)

Whether the widget is the default widget

'has-focus' (boolean : readable / writable / private)

Whether the widget has the input focus

'has-tooltip' (boolean : readable / writable / private)

Whether this widget has a tooltip

'height-request' (integer : readable / writable / private)

Override for height request of the widget, or -1 if natural request should be used

'is-focus' (boolean : readable / writable / private)

Whether the widget is the focus widget within the toplevel

'name' (string : readable / writable / private)

The name of the widget

'no-show-all' (boolean : readable / writable / private)

Whether gtk_widget_show_all() should not affect this widget

'parent' (Gtk2::Container : readable / writable / private)

The parent widget of this widget. Must be a Container widget

'receives-default' (boolean : readable / writable / private)

If TRUE, the widget will receive the default action when it is focused

'sensitive' (boolean : readable / writable / private)

Whether the widget responds to input

'style' (Gtk2::Style : readable / writable / private)

The style of the widget, which contains information about how it will look (colors etc)

'tooltip-markup' (string : readable / writable / private)

The contents of the tooltip for this widget

'tooltip-text' (string : readable / writable / private)

The contents of the tooltip for this widget

'visible' (boolean : readable / writable / private)

Whether the widget is visible

'width-request' (integer : readable / writable / private)

Override for width request of the widget, or -1 if natural request should be used

'window' (Gtk2::Gdk::Window : readable / private)

The widget's window if it is realized

SIGNALS

show (Gtk2::Widget)

hide (Gtk2::Widget)

map (Gtk2::Widget)

unmap (Gtk2::Widget)

realize (Gtk2::Widget)

unrealize (Gtk2::Widget)

size-request (Gtk2::Widget, Gtk2::Requisition)

size-allocate (Gtk2::Widget, Gtk2::Gdk::Rectangle)

state-changed (Gtk2::Widget, Gtk2::StateType)

parent-set (Gtk2::Widget, Gtk2::Widget)

hierarchy-changed (Gtk2::Widget, Gtk2::Widget)

style-set (Gtk2::Widget, Gtk2::Style)

direction-changed (Gtk2::Widget, Gtk2::TextDirection)

grab-notify (Gtk2::Widget, boolean)

child-notify (Gtk2::Widget, Glib::ParamSpec)

boolean = mnemonic-activate (Gtk2::Widget, boolean)

grab-focus (Gtk2::Widget)

boolean = focus (Gtk2::Widget, Gtk2::DirectionType)

move-focus (Gtk2::Widget, Gtk2::DirectionType)

boolean = event (Gtk2::Widget, Gtk2::Gdk::Event)

event-after (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = button-press-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = button-release-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = scroll-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = motion-notify-event (Gtk2::Widget, Gtk2::Gdk::Event)

composited-changed (Gtk2::Widget)

boolean = keynav-failed (Gtk2::Widget, Gtk2::DirectionType)

boolean = delete-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = destroy-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = expose-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = key-press-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = key-release-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = enter-notify-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = leave-notify-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = configure-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = focus-in-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = focus-out-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = map-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = unmap-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = property-notify-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = selection-clear-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = selection-request-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = selection-notify-event (Gtk2::Widget, Gtk2::Gdk::Event)

selection-received (Gtk2::Widget, Gtk2::SelectionData, Glib::UInt)

selection-get (Gtk2::Widget, Gtk2::SelectionData, Glib::UInt, Glib::UInt)

boolean = proximity-in-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = proximity-out-event (Gtk2::Widget, Gtk2::Gdk::Event)

drag-leave (Gtk2::Widget, Gtk2::Gdk::DragContext, Glib::UInt)

drag-begin (Gtk2::Widget, Gtk2::Gdk::DragContext)

drag-end (Gtk2::Widget, Gtk2::Gdk::DragContext)

drag-data-delete (Gtk2::Widget, Gtk2::Gdk::DragContext)

boolean = drag-failed (Gtk2::Widget, Gtk2::Gdk::DragContext, GtkDragResult)

boolean = drag-motion (Gtk2::Widget, Gtk2::Gdk::DragContext, integer, integer, Glib::UInt)

boolean = drag-drop (Gtk2::Widget, Gtk2::Gdk::DragContext, integer, integer, Glib::UInt)

drag-data-get (Gtk2::Widget, Gtk2::Gdk::DragContext, Gtk2::SelectionData, Glib::UInt, Glib::UInt)

drag-data-received (Gtk2::Widget, Gtk2::Gdk::DragContext, integer, integer, Gtk2::SelectionData, Glib::UInt, Glib::UInt)

boolean = visibility-notify-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = client-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = no-expose-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = window-state-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = damage-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = grab-broken-event (Gtk2::Widget, Gtk2::Gdk::Event)

boolean = query-tooltip (Gtk2::Widget, integer, integer, boolean, Gtk2::Tooltip)

boolean = popup-menu (Gtk2::Widget)

boolean = show-help (Gtk2::Widget, Gtk2::WidgetHelpType)

accel-closures-changed (Gtk2::Widget)

screen-changed (Gtk2::Widget, Gtk2::Gdk::Screen)

boolean = can-activate-accel (Gtk2::Widget, Glib::UInt)

Note that currently signal_chain_from_overridden doesn't work from a size-request class closure, because the Gtk2::Requisition parameter you pass ends up getting copied, so changes made to it by the superclass are lost. You can still write a class closure for size-request, but you'll have to calculate the desired size by yourself, you can't chain up to ask your superclass what it thinks.

ENUMS AND FLAGS

flags Gtk2::AccelFlags

•

'visible' / 'GTK_ACCEL_VISIBLE'

•

'locked' / 'GTK_ACCEL_LOCKED'

•

'mask' / 'GTK_ACCEL_MASK'

flags Gtk2::DestDefaults

•

'motion' / 'GTK_DEST_DEFAULT_MOTION'

•

'highlight' / 'GTK_DEST_DEFAULT_HIGHLIGHT'

•

'drop' / 'GTK_DEST_DEFAULT_DROP'

•

'all' / 'GTK_DEST_DEFAULT_ALL'

enum Gtk2::DirectionType

•

'tab-forward' / 'GTK_DIR_TAB_FORWARD'

•

'tab-backward' / 'GTK_DIR_TAB_BACKWARD'

•

'up' / 'GTK_DIR_UP'

•

'down' / 'GTK_DIR_DOWN'

•

'left' / 'GTK_DIR_LEFT'

•

'right' / 'GTK_DIR_RIGHT'

flags Gtk2::Gdk::DragAction

•

'default' / 'GDK_ACTION_DEFAULT'

•

'copy' / 'GDK_ACTION_COPY'

•

'move' / 'GDK_ACTION_MOVE'

•

'link' / 'GDK_ACTION_LINK'

•

'private' / 'GDK_ACTION_PRIVATE'

•

'ask' / 'GDK_ACTION_ASK'

enum Gtk2::Gdk::DragProtocol

•

'motif' / 'GDK_DRAG_PROTO_MOTIF'

•

'xdnd' / 'GDK_DRAG_PROTO_XDND'

•

'rootwin' / 'GDK_DRAG_PROTO_ROOTWIN'

•

'none' / 'GDK_DRAG_PROTO_NONE'

•

'win32-dropfiles' / 'GDK_DRAG_PROTO_WIN32_DROPFILES'

•

'ole2' / 'GDK_DRAG_PROTO_OLE2'

•

'local' / 'GDK_DRAG_PROTO_LOCAL'

flags Gtk2::Gdk::EventMask

•

'exposure-mask' / 'GDK_EXPOSURE_MASK'

•

'pointer-motion-mask' / 'GDK_POINTER_MOTION_MASK'

•

'pointer-motion-hint-mask' / 'GDK_POINTER_MOTION_HINT_MASK'

•

'button-motion-mask' / 'GDK_BUTTON_MOTION_MASK'

•

'button1-motion-mask' / 'GDK_BUTTON1_MOTION_MASK'

•

'button2-motion-mask' / 'GDK_BUTTON2_MOTION_MASK'

•

'button3-motion-mask' / 'GDK_BUTTON3_MOTION_MASK'

•

'button-press-mask' / 'GDK_BUTTON_PRESS_MASK'

•

'button-release-mask' / 'GDK_BUTTON_RELEASE_MASK'

•

'key-press-mask' / 'GDK_KEY_PRESS_MASK'

•

'key-release-mask' / 'GDK_KEY_RELEASE_MASK'

•

'enter-notify-mask' / 'GDK_ENTER_NOTIFY_MASK'

•

'leave-notify-mask' / 'GDK_LEAVE_NOTIFY_MASK'

•

'focus-change-mask' / 'GDK_FOCUS_CHANGE_MASK'

•

'structure-mask' / 'GDK_STRUCTURE_MASK'

•

'property-change-mask' / 'GDK_PROPERTY_CHANGE_MASK'

•

'visibility-notify-mask' / 'GDK_VISIBILITY_NOTIFY_MASK'

•

'proximity-in-mask' / 'GDK_PROXIMITY_IN_MASK'

•

'proximity-out-mask' / 'GDK_PROXIMITY_OUT_MASK'

•

'substructure-mask' / 'GDK_SUBSTRUCTURE_MASK'

•

'scroll-mask' / 'GDK_SCROLL_MASK'

•

'all-events-mask' / 'GDK_ALL_EVENTS_MASK'

enum Gtk2::Gdk::ExtensionMode

•

'none' / 'GDK_EXTENSION_EVENTS_NONE'

•

'all' / 'GDK_EXTENSION_EVENTS_ALL'

•

'cursor' / 'GDK_EXTENSION_EVENTS_CURSOR'

flags Gtk2::Gdk::ModifierType

•

'shift-mask' / 'GDK_SHIFT_MASK'

•

'lock-mask' / 'GDK_LOCK_MASK'

•

'control-mask' / 'GDK_CONTROL_MASK'

•

'mod1-mask' / 'GDK_MOD1_MASK'

•

'mod2-mask' / 'GDK_MOD2_MASK'

•

'mod3-mask' / 'GDK_MOD3_MASK'

•

'mod4-mask' / 'GDK_MOD4_MASK'

•

'mod5-mask' / 'GDK_MOD5_MASK'

•

'button1-mask' / 'GDK_BUTTON1_MASK'

•

'button2-mask' / 'GDK_BUTTON2_MASK'

•

'button3-mask' / 'GDK_BUTTON3_MASK'

•

'button4-mask' / 'GDK_BUTTON4_MASK'

•

'button5-mask' / 'GDK_BUTTON5_MASK'

•

'super-mask' / 'GDK_SUPER_MASK'

•

'hyper-mask' / 'GDK_HYPER_MASK'

•

'meta-mask' / 'GDK_META_MASK'

•

'release-mask' / 'GDK_RELEASE_MASK'

•

'modifier-mask' / 'GDK_MODIFIER_MASK'

enum Gtk2::IconSize

•

'invalid' / 'GTK_ICON_SIZE_INVALID'

•

'menu' / 'GTK_ICON_SIZE_MENU'

•

'small-toolbar' / 'GTK_ICON_SIZE_SMALL_TOOLBAR'

•

'large-toolbar' / 'GTK_ICON_SIZE_LARGE_TOOLBAR'

•

'button' / 'GTK_ICON_SIZE_BUTTON'

•

'dnd' / 'GTK_ICON_SIZE_DND'

•

'dialog' / 'GTK_ICON_SIZE_DIALOG'

enum Gtk2::StateType

•

'normal' / 'GTK_STATE_NORMAL'

•

'active' / 'GTK_STATE_ACTIVE'

•

'prelight' / 'GTK_STATE_PRELIGHT'

•

'selected' / 'GTK_STATE_SELECTED'

•

'insensitive' / 'GTK_STATE_INSENSITIVE'

enum Gtk2::TextDirection

•

'none' / 'GTK_TEXT_DIR_NONE'

•

'ltr' / 'GTK_TEXT_DIR_LTR'

•

'rtl' / 'GTK_TEXT_DIR_RTL'

flags Gtk2::WidgetFlags

•

'toplevel' / 'GTK_TOPLEVEL'

•

'no-window' / 'GTK_NO_WINDOW'

•

'realized' / 'GTK_REALIZED'

•

'mapped' / 'GTK_MAPPED'

•

'visible' / 'GTK_VISIBLE'

•

'sensitive' / 'GTK_SENSITIVE'

•

'parent-sensitive' / 'GTK_PARENT_SENSITIVE'

•

'can-focus' / 'GTK_CAN_FOCUS'

•

'has-focus' / 'GTK_HAS_FOCUS'

•

'can-default' / 'GTK_CAN_DEFAULT'

•

'has-default' / 'GTK_HAS_DEFAULT'

•

'has-grab' / 'GTK_HAS_GRAB'

•

'rc-style' / 'GTK_RC_STYLE'

•

'composite-child' / 'GTK_COMPOSITE_CHILD'

•

'no-reparent' / 'GTK_NO_REPARENT'

•

'app-paintable' / 'GTK_APP_PAINTABLE'

•

'receives-default' / 'GTK_RECEIVES_DEFAULT'

•

'double-buffered' / 'GTK_DOUBLE_BUFFERED'

•

'no-show-all' / 'GTK_NO_SHOW_ALL'

enum Gtk2::WidgetHelpType

•

'tooltip' / 'GTK_WIDGET_HELP_TOOLTIP'

•

'whats-this' / 'GTK_WIDGET_HELP_WHATS_THIS'

enum GtkDragResult

•

'success' / 'GTK_DRAG_RESULT_SUCCESS'

•

'no-target' / 'GTK_DRAG_RESULT_NO_TARGET'

•

'user-cancelled' / 'GTK_DRAG_RESULT_USER_CANCELLED'

•

'timeout-expired' / 'GTK_DRAG_RESULT_TIMEOUT_EXPIRED'

•

'grab-broken' / 'GTK_DRAG_RESULT_GRAB_BROKEN'

•

'error' / 'GTK_DRAG_RESULT_ERROR'

SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::TargetEntry

COPYRIGHT

Copyright (C) 2003-2008 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.