gtkWidgetNew(type, ..., show = TRUE)
gtkWidgetDestroy(object, ...)
gtkWidgetSet(obj, ...)
gtkWidgetUnparent(object)
gtkWidgetShow(object)
gtkWidgetShowNow(object)
gtkWidgetHide(object)
gtkWidgetShowAll(object)
gtkWidgetHideAll(object)
gtkWidgetMap(object)
gtkWidgetUnmap(object)
gtkWidgetRealize(object)
gtkWidgetUnrealize(object)
gtkWidgetQueueDraw(object)
gtkWidgetQueueResize(object)
gtkWidgetQueueResizeNoRedraw(object)
gtkWidgetDraw(object, area)
gtkWidgetSizeRequest(object)
gtkWidgetGetChildRequisition(object)
gtkWidgetSizeAllocate(object, allocation)
gtkWidgetAddAccelerator(object, accel.signal, accel.group, accel.key, accel.mods, accel.flags)
gtkWidgetRemoveAccelerator(object, accel.group, accel.key, accel.mods)
gtkWidgetSetAccelPath(object, accel.path, accel.group)
gtkWidgetListAccelClosures(object)
gtkWidgetCanActivateAccel(object, signal.id)
gtkWidgetEvent(object, event)
gtkWidgetActivate(object)
gtkWidgetReparent(object, new.parent)
gtkWidgetIntersect(object, area, intersection)
gtkWidgetIsFocus(object)
gtkWidgetGrabFocus(object)
gtkWidgetGrabDefault(object)
gtkWidgetSetName(object, name)
gtkWidgetGetName(object)
gtkWidgetSetState(object, state)
gtkWidgetSetSensitive(object, sensitive)
gtkWidgetSetParent(object, parent)
gtkWidgetSetParentWindow(object, parent.window)
gtkWidgetGetParentWindow(object)
gtkWidgetSetUposition(object, x, y)
gtkWidgetSetUsize(object, width, height)
gtkWidgetSetEvents(object, events)
gtkWidgetAddEvents(object, events)
gtkWidgetSetExtensionEvents(object, mode)
gtkWidgetGetExtensionEvents(object)
gtkWidgetGetToplevel(object)
gtkWidgetGetAncestor(object, widget.type)
gtkWidgetGetColormap(object)
gtkWidgetSetColormap(object, colormap)
gtkWidgetGetVisual(object)
gtkWidgetGetEvents(object)
gtkWidgetGetPointer(object)
gtkWidgetIsAncestor(object, ancestor)
gtkWidgetTranslateCoordinates(object, dest.widget, src.x, src.y)
gtkWidgetHideOnDelete(object)
gtkWidgetSetStyle(object, style = NULL)
gtkWidgetEnsureStyle(object)
gtkWidgetGetStyle(object)
gtkWidgetResetRcStyles(object)
gtkWidgetPushColormap(cmap)
gtkWidgetPopColormap()
gtkWidgetSetDefaultColormap(colormap)
gtkWidgetGetDefaultStyle()
gtkWidgetGetDefaultColormap()
gtkWidgetGetDefaultVisual()
gtkWidgetSetDirection(object, dir)
gtkWidgetGetDirection(object)
gtkWidgetSetDefaultDirection(dir)
gtkWidgetGetDefaultDirection()
gtkWidgetShapeCombineMask(object, shape.mask, offset.x, offset.y)
gtkWidgetInputShapeCombineMask(object, shape.mask = NULL, offset.x, offset.y)
gtkWidgetPath(object)
gtkWidgetClassPath(object)
gtkWidgetGetCompositeName(object)
gtkWidgetModifyStyle(object, style)
gtkWidgetGetModifierStyle(object)
gtkWidgetModifyFg(object, state, color = NULL)
gtkWidgetModifyBg(object, state, color = NULL)
gtkWidgetModifyText(object, state, color = NULL)
gtkWidgetModifyBase(object, state, color = NULL)
gtkWidgetModifyFont(object, font.desc = NULL)
gtkWidgetModifyCursor(object, primary, secondary)
gtkWidgetCreatePangoContext(object)
gtkWidgetGetPangoContext(object)
gtkWidgetCreatePangoLayout(object, text)
gtkWidgetRenderIcon(object, stock.id, size, detail = NULL)
gtkWidgetPopCompositeChild()
gtkWidgetPushCompositeChild()
gtkWidgetQueueClear(object)
gtkWidgetQueueClearArea(object, x, y, width, height)
gtkWidgetQueueDrawArea(object, x, y, width, height)
gtkWidgetResetShapes(object)
gtkWidgetSetAppPaintable(object, app.paintable)
gtkWidgetSetDoubleBuffered(object, double.buffered)
gtkWidgetSetRedrawOnAllocate(object, redraw.on.allocate)
gtkWidgetSetCompositeName(object, name)
gtkWidgetSetScrollAdjustments(object, hadjustment = NULL, vadjustment = NULL)
gtkWidgetMnemonicActivate(object, group.cycling)
gtkWidgetClassInstallStyleProperty(klass, pspec)
gtkWidgetClassInstallStylePropertyParser(klass, pspec, parser)
gtkWidgetClassFindStyleProperty(klass, property.name)
gtkWidgetClassListStyleProperties(klass)
gtkWidgetRegionIntersect(object, region)
gtkWidgetSendExpose(object, event)
gtkWidgetStyleGet(object, ...)
gtkWidgetStyleGetProperty(object, property.name)
gtkWidgetStyleAttach(object)
gtkWidgetGetAccessible(object)
gtkWidgetChildFocus(object, direction)
gtkWidgetChildNotify(object, child.property)
gtkWidgetFreezeChildNotify(object)
gtkWidgetGetChildVisible(object)
gtkWidgetGetParent(object)
gtkWidgetGetSettings(object)
gtkWidgetGetClipboard(object, selection)
gtkWidgetGetDisplay(object)
gtkWidgetGetRootWindow(object)
gtkWidgetGetScreen(object)
gtkWidgetHasScreen(object)
gtkWidgetGetSizeRequest(object)
gtkWidgetSetChildVisible(object, is.visible)
gtkWidgetSetSizeRequest(object, width, height)
gtkWidgetThawChildNotify(object)
gtkWidgetSetNoShowAll(object, no.show.all)
gtkWidgetGetNoShowAll(object)
gtkWidgetListMnemonicLabels(object)
gtkWidgetAddMnemonicLabel(object, label)
gtkWidgetRemoveMnemonicLabel(object, label)
gtkWidgetGetAction(object)
gtkWidgetGetAction(object)
gtkWidgetIsComposited(object)
gtkWidgetErrorBell(object)
gtkWidgetKeynavFailed(object, direction)
gtkWidgetGetTooltipMarkup(object)
gtkWidgetSetTooltipMarkup(object, markup)
gtkWidgetGetTooltipText(object)
gtkWidgetSetTooltipText(object, text)
gtkWidgetGetTooltipWindow(object)
gtkWidgetSetTooltipWindow(object, custom.window)
gtkWidgetGetHasTooltip(object)
gtkWidgetSetHasTooltip(object, has.tooltip)
gtkWidgetTriggerTooltipQuery(object)
gtkWidgetGetSnapshot(object, clip.rect = NULL)
gtkWidgetGetWindow(object)
gtkWidgetGetAllocation(object)
gtkWidgetSetAllocation(object, allocation)
gtkWidgetGetAppPaintable(object)
gtkWidgetGetCanDefault(object)
gtkWidgetSetCanDefault(object, can.default)
gtkWidgetGetCanFocus(object)
gtkWidgetSetCanFocus(object, can.focus)
gtkWidgetGetDoubleBuffered(object)
gtkWidgetGetHasWindow(object)
gtkWidgetSetHasWindow(object, has.window)
gtkWidgetGetSensitive(object)
gtkWidgetIsSensitive(object)
gtkWidgetGetState(object)
gtkWidgetGetVisible(object)
gtkWidgetSetVisible(object, visible)
gtkWidgetHasDefault(object)
gtkWidgetHasFocus(object)
gtkWidgetHasGrab(object)
gtkWidgetHasRcStyle(object)
gtkWidgetIsDrawable(object)
gtkWidgetIsToplevel(object)
gtkWidgetSetWindow(object, window)
gtkWidgetSetReceivesDefault(object, receives.default)
gtkWidgetGetReceivesDefault(object)
gtkWidgetSetRealized(object, realized)
gtkWidgetGetRealized(object)
gtkWidgetSetMapped(object, mapped)
gtkWidgetGetMapped(object)
gtkWidgetGetRequisition(object)
gtkRequisitionCopy(object)
gtkWidget(type, ..., show = TRUE)
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkMisc +----GtkCalendar +----GtkCellView +----GtkDrawingArea +----GtkEntry +----GtkRuler +----GtkRange +----GtkSeparator +----GtkHSV +----GtkInvisible +----GtkOldEditable +----GtkPreview +----GtkProgress GBoxed +----GtkRequisition GBoxed +----GtkSelectionData
GtkBuildable
.GtkCellEditable
, GtkFileChooser
and GtkToolShell
.GtkWidget
introduces style
properties - these are basically object properties that are stored
not on the object, but in the style object associated to the widget. Style
properties are set in resource files.
This mechanism is used for configuring such things as the location of the
scrollbar arrows through the theme, giving theme authors more control over the
look of applications without the need to write a theme engine in C. Use gtkWidgetClassInstallStyleProperty
to install style properties for
a widget class, gtkWidgetClassFindStyleProperty
or
gtkWidgetClassListStyleProperties
to get information about existing
style properties and gtkWidgetStyleGetProperty
, gtkWidgetStyleGet
or
gtkWidgetStyleGetValist()
to obtain the value of a style property. GtkWidget as GtkBuildable
The GtkWidget implementation of the GtkBuildable interface supports a
custom In addition to accelerators,
GtkWidget
also support a
custom GtkWidget
. A UI definition fragment specifying an accessibleGtkWidget
style
GtkStyle
] requisition
GtkRequisition
] allocation
GtkAllocation
] window
GdkWindow
] parent
GtkWidget
] GtkWidgetClass
activate_signal
The signal to emit when a widget of this class is activated,
gtkWidgetActivate
handles the emission. Implementation of this
signal is optional.
set_scroll_adjustment_signal
This signal is emitted when a widget of this class is added
to a scrolling aware parent, gtkWidgetSetScrollAdjustments
handles the emission.
Implementation of this signal is optional. GtkRequisition
GtkRequisition
represents the desired size of a widget. See
for more information. width
height
GtkAllocation
GtkAllocation
of a widget represents region which has been allocated to the
widget by its parent. It is a subregion of its parents allocation. See
for more information.
GtkAllocation
is a transparent-type. x
y
width
height
GtkSelectionData
gtkWidget
is the equivalent of gtkWidgetNew
.GtkWidgetFlags
toplevel
GtkWindow
s and
GtkMenu
s have this flag set throughout their lifetime.
Toplevel widgets always contain their own GdkWindow
.no-window
GdkWindow
.
Visible action (e.g. drawing) is performed on the parent's GdkWindow
.realized
gtkWidgetRealize
, unset by gtkWidgetUnrealize
.
A realized widget has an associated GdkWindow
.mapped
gtkWidgetMap
, unset by gtkWidgetUnmap
.
Only realized widgets can be mapped. It means that gdkWindowShow
has been called on the widgets window(s).visible
gtkWidgetShow
, unset by gtkWidgetHide
. Implies that a
widget will be mapped as soon as its parent is mapped.sensitive
gtkWidgetSetSensitive
.
The sensitivity of a widget determines whether it will receive
certain events (e.g. button or key presses). One premise for
the widget's sensitivity is to have this flag set.parent-sensitive
gtkWidgetSetSensitive
operations on the
parents of the widget.
This is the second premise for the widget's sensitivity. Once
it has GTK_SENSITIVE
and GTK_PARENT_SENSITIVE
set, its state is
effectively sensitive. This is expressed (and can be examined) by
the GTK_WIDGET_IS_SENSITIVE
function.can-focus
has-focus
gtkWidgetGrabFocus
for widgets that also
have GTK_CAN_FOCUS
set. The flag will be unset once another widget
grabs the focus.can-default
gtkWidgetGrabDefault
and will reserve space to draw the default if possiblehas-default
has-grab
gtkGrabAdd
, unset by gtkGrabRemove
. 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.rc-style
composite-child
gtkWidgetPushCompositeChild
, gtkWidgetPopCompositeChild
.no-reparent
app-paintable
gtkWidgetSetAppPaintable
.
Must be set on widgets whose window the application directly draws on,
in order to keep GTK+ from overwriting the drawn stuff. See
for a detailed
description of this flag.receives-default
GTK_HAS_DEFAULT
set even if there is a different widget set as default.double-buffered
gtkWidgetSetDoubleBuffered
.
Indicates that exposes done on the widget should be
double-buffered. See for a
detailed discussion of how double-buffering works in GTK+ and
why you may want to disable it for special cases.no-show-all
GtkWidgetHelpType
tooltip
whats-this
GtkTextDirection
none
ltr
rtl
accel-closures-changed(widget, user.data)
widget
user.data
button-press-event(widget, event, user.data)
GdkWindow
associated to the
widget needs to enable the GDK_BUTTON_PRESS_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventButton
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. button-release-event(widget, event, user.data)
GdkWindow
associated to the
widget needs to enable the GDK_BUTTON_RELEASE_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventButton
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. can-activate-accel(widget, signal.id, user.data)
signal.id
can currently be activated.
This signal is present to allow applications and derived
widgets to override the default GtkWidget
handling
for determining whether an accelerator can be activated. widget
signal.id
widget
user.data
TRUE
if the signal can be activated. child-notify(widget, pspec, user.data)
widget
pspec
GParamSpec
of the changed child propertyuser.data
client-event(widget, event, user.data)
widget
's window
receives a message (via a ClientMessage event) from another
application. widget
event
GdkEventClient
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for
the event. FALSE
to propagate the event further. composited-changed(widget, user.data)
widget
s screen changes.
See gdkScreenIsComposited
. widget
user.data
configure-event(widget, event, user.data)
widget
's window has changed. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_STRUCTURE_MASK
mask. GDK will enable this mask
automatically for all new windows. widget
event
GdkEventConfigure
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. damage-event(widget, event, user.data)
widget
gets drawn into.
The region/area members of the event shows what area of the redirected
drawable was drawn into.
Since 2.14 widget
event
GdkEventExpose
eventuser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. delete-event(widget, event, user.data)
gtkWidgetHideOnDelete
to
this signal will cause the window to be hidden instead, so that
it can later be shown again without reconstructing it. widget
event
user.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. destroy-event(widget, event, user.data)
GdkWindow
is destroyed.
You rarely get this signal, because most widgets disconnect themselves
from their window before they destroy it, so no widget owns the
window at destroy time. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_STRUCTURE_MASK
mask. GDK will enable this mask
automatically for all new windows. widget
event
user.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. direction-changed(widget, previous.direction, user.data)
widget
previous.direction
widget
user.data
drag-begin(widget, drag.context, user.data)
gtkDragSourceSetIcon
. Note that some widgets set up a drag icon in the default handler of
this signal, so you may have to use gSignalConnectAfter()
to
override what the default handler did. widget
drag.context
user.data
drag-data-delete(widget, drag.context, user.data)
GDK_ACTION_MOVE
is successfully completed. The signal
handler is responsible for deleting the data that has been dropped. What
"delete" means depends on the context of the drag operation. widget
drag.context
user.data
drag-data-get(widget, drag.context, data, info, time, user.data)
data
with the data in the format which
is indicated by info
. See gtkSelectionDataSet
and
gtkSelectionDataSetText
. widget
drag.context
data
GtkSelectionData
to be filled with the dragged datainfo
GtkTargetList
time
user.data
drag-data-received(widget, drag.context, x, y, data, info, time, user.data)
gdkDragStatus
and not finish the drag.
If the data was received in response to a "drag-drop"
signal
(and this is the last target to be received), the handler for this
signal is expected to process the received data and then call
gtkDragFinish
, setting the success
parameter depending on whether
the data was processed successfully. The handler may inspect and modify drag.context->action
before calling
gtkDragFinish
, e.g. to implement GDK_ACTION_ASK
as shown in the
following example:
drag_data_received <- function(widget, drag_context, x, y, data, info, time) { if (data$getLength() > 0L) { if (drag_context$getAction() == "ask") { dialog <- gtkMessageDialog(NULL, c("modal", "destroy-with-parent"), "info", "yes-no", "Move the data ?\n") response <- dialog$run() dialog$destroy() ### FIXME: setAction() not yet supported if (response == GtkResponseType["yes"]) drag_context$setAction("move") else drag_context$setAction("copy") } gtkDragFinish(drag_context, TRUE, FALSE, time) } gtkDragFinish (drag_context, FALSE, FALSE, time) }
widget
drag.context
x
y
data
info
GtkTargetList
time
user.data
drag-drop(widget, drag.context, x, y, time, returns, user.data)
FALSE
and no further processing is necessary.
Otherwise, the handler returns TRUE
. In this case, the handler must
ensure that gtkDragFinish
is called to let the source know that
the drop is done. The call to gtkDragFinish
can be done either
directly or in a "drag-data-received"
handler which gets
triggered by calling gtkDragGetData
to receive the data for one
or more of the supported targets. widget
drag.context
x
y
time
returns
user.data
drag-end(widget, drag.context, user.data)
"drag-begin"
. widget
drag.context
user.data
drag-failed(widget, drag.context, result, user.data)
TRUE
is the failure has
been already handled (not showing the default "drag operation failed"
animation), otherwise it returns FALSE
.
Since 2.12 widget
drag.context
result
user.data
TRUE
if the failed drag operation has been already handled. drag-leave(widget, drag.context, time, user.data)
"drag-motion"
, e.g. undo highlighting
with gtkDragUnhighlight
widget
drag.context
time
user.data
drag-motion(widget, drag.context, x, y, time, returns, user.data)
FALSE
and no further processing
is necessary. Otherwise, the handler returns TRUE
. In this case, the
handler is responsible for providing the necessary information for
displaying feedback to the user, by calling gdkDragStatus
. If the decision whether the drop will be accepted or rejected can't be
made based solely on the cursor position and the type of the data, the
handler may inspect the dragged data by calling gtkDragGetData
and
defer the gdkDragStatus
call to the "drag-data-received"
handler. Note that you cannot not pass GTK_DEST_DEFAULT_DROP
,
GTK_DEST_DEFAULT_MOTION
or GTK_DEST_DEFAULT_ALL
to gtkDragDestSet
when using the drag-motion signal that way. Also note that there is no drag-enter signal. The drag receiver has to
keep track of whether he has received any drag-motion signals since the
last "drag-leave"
and if not, treat the drag-motion signal as
an "enter" signal. Upon an "enter", the handler will typically highlight
the drop site with gtkDragHighlight
.
drag_motion <- function(widget, context, x, y, time) { state <- widget$getData("drag-state") if (!state$drag_highlight) { state$drag_highlight <- T gtkDragHighlight(widget) } target <- gtkDragDestFindTarget(widget, context, NULL) if (target == 0) gdkDragStatus(context, 0, time) else { state$pending_status <- context[["suggestedAction"]] gtkDragGetData(widget, context, target, time) } widget$setData("drag-state", state) return(TRUE) } drag_data_received <- function(widget, context, x, y, selection_data, info, time) { state <- widget$getData("drag-state") if (state$pending_status) { ## We are getting this data due to a request in drag_motion, ## rather than due to a request in drag_drop, so we are just ## supposed to call gdk_drag_status(), not actually paste in the data. str <- gtkSelectionDataGetText(selection_data) if (!data_is_acceptable (str)) gdkDragStatus(context, 0, time) else gdkDragStatus(context, state$pending_status, time) state$pending_status <- 0 } else { ## accept the drop } widget$setData("drag-state", state) }
widget
drag.context
x
y
time
returns
user.data
enter-notify-event(widget, event, user.data)
widget
's window. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_ENTER_NOTIFY_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventCrossing
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. event(widget, event, user.data)
"key-press-event"
) and finally a generic
"event-after"
signal. widget
event
GdkEvent
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event
and to cancel the emission of the second specific ::event signal.
FALSE
to propagate the event further and to allow the emission of
the second signal. The ::event-after signal is emitted regardless of
the return value. event-after(widget, event, user.data)
gtkWidgetEvent
signal and (optionally)
the second more specific signal, ::event-after will be emitted
regardless of the previous two signals handlers return values. widget
event
GdkEvent
which triggered this signaluser.data
expose-event(widget, event, user.data)
GdkWindow
is made visible and needs to be redrawn.
GTK_NO_WINDOW
widgets will get a synthesized event from their parent
widget. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_EXPOSURE_MASK
mask. widget
event
GdkEventExpose
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. focus(widget, user.data)
widget
user.data
TRUE
to stop other handlers from being invoked for the event. FALSE
to propagate the event further. focus-in-event(widget, event, user.data)
widget
's window. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_FOCUS_CHANGE_MASK
mask. widget
event
GdkEventFocus
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. focus-out-event(widget, event, user.data)
widget
's window. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_FOCUS_CHANGE_MASK
mask. widget
event
GdkEventFocus
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. grab-broken-event(widget, event, user.data)
widget
gets broken. On X11, this happens when the grab window becomes unviewable
(i.e. it or one of its ancestors is unmapped), or if the same
application grabs the pointer or keyboard again.
Since 2.8 widget
event
GdkEventGrabBroken
eventuser.data
TRUE
to stop other handlers from being invoked for
the event. FALSE
to propagate the event further. grab-focus(widget, user.data)
widget
user.data
grab-notify(widget, was.grabbed, user.data)
gtkGrabAdd
when the topmost
grab widget in the grab stack of its window group is not
its ancestor. widget
was.grabbed
FALSE
if the widget becomes shadowed, TRUE
if it becomes unshadoweduser.data
hide(widget, user.data)
widget
user.data
hierarchy-changed(widget, previous.toplevel, user.data)
GtkWindow
. This signal is emitted when
a widget changes from un-anchored to anchored or vice-versa. widget
previous.toplevel
NULL
if the widget was previously unanchored. [ allow-none ]user.data
key-press-event(widget, event, user.data)
GdkWindow
associated to the widget needs
to enable the GDK_KEY_PRESS_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventKey
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. key-release-event(widget, event, user.data)
GdkWindow
associated to the widget needs
to enable the GDK_KEY_RELEASE_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventKey
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. keynav-failed(widget, direction, user.data)
gtkWidgetKeynavFailed
for details.
Since 2.12 widget
direction
user.data
TRUE
if stopping keyboard navigation is fine, FALSE
if the emitting widget should try to handle the keyboard
navigation attempt in its parent container(s). leave-notify-event(widget, event, user.data)
widget
's window. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_LEAVE_NOTIFY_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventCrossing
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. map(widget, user.data)
widget
user.data
map-event(widget, event, user.data)
widget
's window is
mapped. A window is mapped when it becomes visible on the screen. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_STRUCTURE_MASK
mask. GDK will enable this mask
automatically for all new windows. widget
event
GdkEventAny
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. mnemonic-activate(widget, user.data)
widget
user.data
motion-notify-event(widget, event, user.data)
GdkWindow
. To receive this signal, the GdkWindow
associated to the widget
needs to enable the GDK_POINTER_MOTION_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventMotion
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. move-focus(widget, user.data)
widget
user.data
no-expose-event(widget, event, user.data)
widget
's window is
drawn as a copy of another GdkDrawable
(with gdkDrawDrawable
or
gdkWindowCopyArea()
) which was completely unobscured. If the source
window was partially obscured GdkEventExpose
events will be generated
for those areas. widget
event
GdkEventNoExpose
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. parent-set(widget, old.parent, user.data)
widget
old.parent
NULL
if the widget
just got its initial parent. [ allow-none ]user.data
popup-menu(widget, user.data)
GtkEntry
widget creates
a menu with clipboard commands. See
for an example of how to use this signal. widget
user.data
TRUE
if a menu was activated property-notify-event(widget, event, user.data)
widget
's window has been changed or deleted. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_PROPERTY_CHANGE_MASK
mask. widget
event
GdkEventProperty
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. proximity-in-event(widget, event, user.data)
GdkWindow
associated to the widget needs
to enable the GDK_PROXIMITY_IN_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventProximity
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. proximity-out-event(widget, event, user.data)
GdkWindow
associated to the widget needs
to enable the GDK_PROXIMITY_OUT_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventProximity
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. query-tooltip(widget, x, y, keyboard.mode, tooltip, user.data)
"has-tooltip"
is TRUE
and the "gtk-tooltip-timeout"
has expired with the cursor hovering "above" widget
; or emitted when widget
got
focus in keyboard mode. Using the given coordinates, the signal handler should determine
whether a tooltip should be shown for widget
. If this is the case
TRUE
should be returned, FALSE
otherwise. Note that if
keyboard.mode
is TRUE
, the values of x
and y
are undefined and
should not be used. The signal handler is free to manipulate tooltip
with the therefore
destined function calls.
Since 2.12 widget
x
widget->window
y
widget->window
keyboard.mode
TRUE
if the tooltip was trigged using the keyboardtooltip
GtkTooltip
user.data
TRUE
if tooltip
should be shown right now, FALSE
otherwise. realize(widget, user.data)
widget
user.data
screen-changed(widget, previous.screen, user.data)
widget
previous.screen
NULL
if the
widget was not associated with a screen before. [ allow-none ]user.data
scroll-event(widget, event, user.data)
GdkWindow
associated to the widget needs
to enable the GDK_BUTTON_PRESS_MASK
mask. This signal will be sent to the grab widget if there is one. widget
event
GdkEventScroll
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. selection-clear-event(widget, event, user.data)
widget
's window has lost ownership of a selection. widget
event
GdkEventSelection
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. selection-get(widget, user.data)
widget
user.data
selection-notify-event(widget, user.data)
widget
user.data
TRUE
to stop other handlers from being invoked for the event. FALSE
to propagate the event further. selection-received(widget, user.data)
widget
user.data
selection-request-event(widget, event, user.data)
widget
's window. widget
event
GdkEventSelection
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. show(widget, user.data)
widget
user.data
show-help(widget, user.data)
widget
user.data
size-allocate(widget, user.data)
widget
user.data
size-request(widget, user.data)
widget
user.data
state-changed(widget, state, user.data)
gtkWidgetGetState
. widget
state
user.data
style-set(widget, previous.style, user.data)
gtkWidgetModifyBase
also cause this signal to be emitted. widget
previous.style
NULL
if the widget
just got its initial style. [ allow-none ]user.data
unmap(widget, user.data)
widget
user.data
unmap-event(widget, event, user.data)
widget
's window is
unmapped. A window is unmapped when it becomes invisible on the screen. To receive this signal, the GdkWindow
associated to the widget needs
to enable the GDK_STRUCTURE_MASK
mask. GDK will enable this mask
automatically for all new windows. widget
event
GdkEventAny
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. unrealize(widget, user.data)
widget
user.data
visibility-notify-event(widget, event, user.data)
widget
's window
is obscured or unobscured. To receive this signal the GdkWindow
associated to the widget needs
to enable the GDK_VISIBILITY_NOTIFY_MASK
mask. widget
event
GdkEventVisibility
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. window-state-event(widget, event, user.data)
widget
changes. To receive this signal the GdkWindow
associated to the widget
needs to enable the GDK_STRUCTURE_MASK
mask. GDK will enable
this mask automatically for all new windows. widget
event
GdkEventWindowState
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the
event. FALSE
to propagate the event further. app-paintable
[logical : Read / Write]can-default
[logical : Read / Write]can-focus
[logical : Read / Write]composite-child
[logical : Read]double-buffered
[logical : Read / Write]events
[GdkEventMask
: Read / Write]extension-events
[GdkExtensionMode
: Read / Write]has-default
[logical : Read / Write]has-focus
[logical : Read / Write]has-tooltip
[logical : Read / Write]"query-tooltip"
on widget
.
A value of TRUE
indicates that widget
can have a tooltip, in this case
the widget will be queried using "query-tooltip"
to determine
whether it will provide a tooltip or not. Note that setting this property to TRUE
for the first time will change
the event masks of the GdkWindows of this widget to include leave-notify
and motion-notify events. This cannot and will not be undone when the
property is set to FALSE
again.
Default value: FALSE Since 2.12 height-request
[integer : Read / Write]is-focus
[logical : Read / Write]name
[character : * : Read / Write]no-show-all
[logical : Read / Write]parent
[GtkContainer
: * : Read / Write]receives-default
[logical : Read / Write]sensitive
[logical : Read / Write]style
[GtkStyle
: * : Read / Write]tooltip-markup
[character : * : Read / Write]gtkTooltipSetMarkup
. This is a convenience property which will take care of getting the
tooltip shown if the given string is not NULL
: "has-tooltip"
will automatically be set to TRUE
and there will be taken care of
"query-tooltip"
in the default signal handler.
Default value: NULL Since 2.12 tooltip-text
[character : * : Read / Write]gtkTooltipSetText
. This is a convenience property which will take care of getting the
tooltip shown if the given string is not NULL
: "has-tooltip"
will automatically be set to TRUE
and there will be taken care of
"query-tooltip"
in the default signal handler.
Default value: NULL Since 2.12 visible
[logical : Read / Write]width-request
[integer : Read / Write]window
[GdkWindow
: * : Read]NULL
otherwise.
Since 2.14 cursor-aspect-ratio
[numeric : Read]cursor-color
[GdkColor
: * : Read]draw-border
[GtkBorder
: * : Read]focus-line-pattern
[character : * : Read]focus-line-width
[integer : Read]focus-padding
[integer : Read]interior-focus
[logical : Read]link-color
[GdkColor
: * : Read]scroll-arrow-hlength
[integer : Read]scroll-arrow-vlength
[integer : Read]secondary-cursor-color
[GdkColor
: * : Read]separator-height
[integer : Read]"wide-separators"
is TRUE
.
Allowed values: >= 0 Default value: 0 Since 2.10 separator-width
[integer : Read]"wide-separators"
is TRUE
.
Allowed values: >= 0 Default value: 0 Since 2.10 visited-link-color
[GdkColor
: * : Read]wide-separators
[logical : Read]