PHP-GTK Manual - Base class for user interface elements.

GtkWidget

Base class for user interface elements.

Object Hierarchy

GtkObject
`-- GtkWidget

Description

GtkWidget is an abstract base class providing its descendants with properties, methods and signals pertinent to displayable user interface elements. The only objects that do not inherit GtkWidget characteristics are GtkTooltips, GtkAdjustment and GtkItemFactory - all of which are relatively abstract concepts. Everything else that is a member of the object hierarchy is a descendant of the GtkWidget class, takes up screen space, and may be referred to as a widget.

Note that GtkWidget cannot be constructed directly.

Methods

drag_highlight()

drag_unhighlight()

drag_dest_unset()

drag_source_unset()

drag_source_set_icon()

selection_owner_set()

selection_add_target()

selection_convert()

selection_remove_all()

unparent()
Dissociates widget from current parent.
show()
Displays the calling widget.
show_now()
Shows a widget and enters the main loop.
hide()
Hides the calling widget.
show_all()
Displays calling widget and its children.
hide_all()
Hides calling widget and its children.
map()
Maps calling widget to the screen.
unmap()
Unmaps calling widget from the screen.
realize()
Instantiates calling widget's GdkWindow.
unrealize()
Removes calling widget's GdkWindow.
queue_draw()
Queues widget's redraw requests, for the whole widget.
queue_draw_area()
Queues widget's redraw requests, for any area within the widget.
queue_clear()

queue_clear_area()

queue_resize()
Queues widget's resize requests.
draw()

draw_focus()

draw_default()

add_accelerator()
Adds accelerator key to a widget.
remove_accelerator()
Removes a single accelerator.
remove_accelerators()
Removes all accelerators meeting certain criteria.
lock_accelerators()
Locks accelerator key definitions.
unlock_accelerators()
Unlocks accelerators to allow alterations.
accelerators_locked()
Tests accelerator lock status.
event()
Triggers an event.
activate()

reparent()
Moves a widget to a new container.
popup()

intersect()
Checks for an intersection with a given area.
grab_focus()
Gives grab and focus to the calling widget.
grab_default()
Gives grab and default to the calling widget.
set_name()
Sets widget name.
get_name()
Returns name of widget.
set_state()
Sets widget's state.
set_sensitive()
Toggles sensitivity.
set_app_paintable()

set_parent()
Sets the parent of the widget.
set_parent_window()

get_parent_window()

set_uposition()
Sets widget's position relative to its container.
set_usize()
Sets widget's size in pixels.
set_events()
Extends capturable events prior to realization.
add_events()
Extends capturable events after realization.
get_toplevel()

get_ancestor()

get_colormap()
Returns the GdkColormap object used by the widget.
get_visual()
Returns the GdkVisual object used by the widget.
set_colormap()
Sets the widget's colormap.
set_visual()

get_events()

is_ancestor()
Tests relationship with other widgets.
hide_on_delete()

set_style()
Sets a widget's style property.
set_rc_style()

ensure_style()

get_style()
Returns the GtkStyle object used by the widget.
restore_default_style()

set_composite_name()

get_composite_name()

reset_rc_styles()

shape_combine_mask()
Give the widget an unusual shape.

Signals

"show"

"hide"

"map"

"unmap"

"realize"

"unrealize"

"draw"

"draw-focus"

"draw-default"

"size-request"

"size-allocate"

"state-changed"

"parent-set"

"style-set"

"add-accelerator"

"remove-accelerator"

"grab-focus"

"event"
Emitted when any event is captured.
"button-press-event"
Emitted when a GDK_BUTTON_PRESS event is captured.
"button-release-event"
Emitted when a GDK_BUTTON_RELEASE event is captured.
"motion-notify-event"
Emitted when a GDK_MOTION_NOTIFY event is captured.
"delete-event"
Emitted when a GDK_DELETE event is captured.
"destroy-event"
Emitted when a GDK_DESTROY event is captured.
"expose-event"
Emitted when a GDK_EXPOSE event is captured.
"key-press-event"
Emitted when a GDK_KEY_PRESS event is captured.
"key-release-event"
Emitted when a GDK_KEY_RELEASE event is captured.
"enter-notify-event"
Emitted when a GDK_ENTER_NOTIFY event is captured.
"leave-notify-event"
Emitted when a GDK_LEAVE_NOTIFY event is captured.
"configure-event"
Emitted when a GDK_CONFIGURE event is captured.
"focus-in-event"
Emitted when a GDK_FOCUS_CHANGE event is captured.
"focus-out-event"
Emitted when a GDK_FOCUS_CHANGE event is captured.
"map-event"
Emitted when a GDK_MAP event is captured.
"unmap-event"
Emitted when a GDK_UNMAP event is captured.
"property-notify-event"
Emitted when a GDK_PROPERTY_NOTIFY event is captured.
"selection-clear-event"
Emitted when a GDK_SELECTION_CLEAR event is captured.
"selection-request-event"
Emitted when a GDK_SELECTION_REQUEST event is captured.
"selection-notify-event"
Emitted when a GDK_SELECTION_NOTIFY event is captured.
"selection-received"

"selection-get"

"proximity-in-event"
Emitted when a GDK_PROXIMITY_IN event is captured.
"proximity-out-event"
Emitted when a GDK_PROXIMITY_OUT event is captured.
"drag-leave"

"drag-begin"

"drag-end"

"drag-data-delete"

"drag-motion"

"drag-drop"

"drag-data-get"

"drag-data-received"

"visibility-notify-event"
Emitted when a GDK_VISIBILITY_NOTIFY event is captured.
"client-event"
Emitted when a GDK_CLIENT_EVENT event is captured.
"no-expose-event"

"debug-msg"

Properties

style:
Style associated with a widget.
window:
Underlying GdkWindow that captures events on a widget.
allocation:
Size and position allocated to a widget.
state:
Degree of response to events.
parent:
A widget's parent.