gtk-sharpGtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details.GLib.InitiallyUnownedAtk.IImplementorGLib.TypeInitializer(typeof(Gtk.Widget), "ClassInit")GtkWidget introduces style properties - these are basically object properties that are stored in the style object associated to the .
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 to obtain the value of a style property.
ConstructorProtected constructor.Constructor
Pointer to the C object.
Internal constructorThis is an internal constructor, and should not be used by user code.EventGLib.Signal("can-activate-accel")Gtk.AccelCanActivateHandler
This signal is present to allow applications and derived
widgets to override the default Gtk.Widget handling
for determining whether an accelerator can be activated.
See for more details.EventGLib.Signal("accel-closures-changed")System.EventHandlerRaised when the closures for this widget's accelerator change.PropertyAtk.ObjectObtains the default reading direction for .A .Obtains the default reading direction for .MethodSystem.BooleanFor that can be "activated" (buttons, menu items, etc.) this method activates them.Returns if the was activatable.
Activation is what happens when you press Enter on a widget during key navigation; clicking a button, selecting a menu item, etc. If the isn't activatable, the method returns .
MethodSystem.Void
Widget signal to emit on accelerator activation.
Accel group for this , added to its toplevel.
GDK keyval of the accelerator.
Installs an accelerator for this in that causes to be emitted if the accelerator is activated.
The needs to be added to the widget's toplevel via , and the signal must be of type G_RUN_ACTION. Accelerators added through this method are not user changeable during runtime.
Accelerators added through this method are not user changeable during runtime. If you want to support accelerators that can be changed by the user, use instead.
MethodSystem.Void
Widget signal to emit on accelerator activation.
Accel group for this , added to its toplevel.
GDK keyval of the accelerator.
Modifier key combination of the accelerator.
Flag accelerators.
Installs an accelerator for this in that causes to be emitted if the accelerator is activated.
The needs to be added to the widget's toplevel via , and the signal must be of type G_RUN_ACTION. Accelerators added through this method are not user changeable during runtime.
Accelerators added through this method are not user changeable during runtime. If you want to support accelerators that can be changed by the user, use instead.
MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.VoidAdds the events in the bitfield to the event mask for .
See for details.
MethodSystem.Void
a Adds a widget to the list of mnemonic labels for this widget.(See ). Note the list of mnemonic labels for the widget is cleared when the widget is destroyed, so the caller must make sure to update its internal state at this point as well, by using a connection to the Destroy signal or a weak notifier.PropertySystem.Int32To be added.To be added.To be added.PropertySystem.Int32To be added.To be added.To be added.PropertyGdk.RectangleGets or Sets the widget's allocation.a representing the size of the widget's allocation.
When the top-level widget has determined how much space its child would like to have, the second phase of the size negotiation, size allocation, begins. Depending on its configuration (see ), the top-level widget may be able to expand in order to satisfy the size request or it may have to ignore the size request and keep its fixed size. It then tells its child widget how much space it gets by calling . The child widget divides the space among its children and tells each child how much space it got, and so on. Under normal circumstances, a will always give its child the amount of space the child requested.
A child's size allocation is represented by a . This struct contains not only a width and height, but also a position (i.e. X and Y coordinates), so that containers can tell their children not only how much space they have gotten, but also where they are positioned inside the space available to the container.
Widgets are required to honor the size allocation they receive; a size request is only a request, and widgets must be able to cope with any size.
None.PropertyGLib.Property("app-paintable")System.BooleanWhether the application will paint directly on the . if the application will paint directly on the .EventGLib.Signal("button-press-event")Gtk.ButtonPressEventHandlerRaised when a button is pressed.EventGLib.Signal("button-release-event")Gtk.ButtonReleaseEventHandlerRaised when a (mouse) button is released on this widget.MethodSystem.Boolean
a , a signal ID (XXX: API: should this really work this way?)
Determines whether an accelerator that activates the signal
identified by can currently be activated.
a , true if the accelerator can be activated.
This is done by emitting the
signal on the widget; if the signal isn't overridden by a
handler or in a derived widget, then the default check is
that the widget must be sensitive, and the widget and all
its ancestors mapped.
PropertyGLib.Property("can-default")System.BooleanEvaluates to if the is allowed to receive the default focus. that indicates if the widget can grab the default focus, using .
When this property is set to true, the widget itself will reserve space to
draw the default if possible.
If either the widget's property or
the 's property evaluates
to false, the property will return false. Otherwise, the
property will return its own value.
Typically, you'd like to set the default widget using
, but you must set the
property to true before you call it, in order to force the focus to be grabbed
into the widget.
When certain conditions are met and the user press Enter, the default
widget will be focused. Conditions: the property is set
to true, the has been called and
the containing the widget have the focus.
This state is common when your window is shown for the first time, and no
call has been made (or when by no
other means, the focus has been set to any particular widget).
[FIXME] This is a seealso instead see [FIXME] This is a seealso instead seePropertyGLib.Property("can-focus")System.BooleanDetermines whether the is able to receive the focus.Evaluates to if the is able to
handle focus grabs.
If the widget property evaluates
to , the property will also return
. widget
must be a focusable widget, such as an ; something
like won't work. More precisely, it must have the
property set.
The property is just the helper that will tell you whether
the widget is focusable.
Evaluate it before you make a call to ,
if you are unsure about the "focusability" of the widget.
[FIXME] This two links are seealso instead see: and
MethodSystem.Boolean
Direction of focus movement.
Move focus to particular . if focus ended up inside .
This method is used by custom implementations; if you're writing an app, you'd use to move the focus to a particular , and to change the focus tab order. So you may want to investigate those methods instead.
is called by containers as the user moves around the window using keyboard shortcuts. indicates what kind of motion is taking place (up, down, left, right, tab forward, tab backward). invokes the event on ; override the default handler for this event in order to implement appropriate focus behavior.
The "focus" default handler for a should return if moving in direction left the focus on a focusable location inside that , and if moving in direction moved the focus outside the . If returning , normally call to place the focus accordingly; if returning , they don't modify the current focus location.
EventGLib.Signal("child-notify")Gtk.ChildNotifiedHandlerEmitted when a child has been notified.MethodSystem.Void
The name of a child property installed on the class of widget's parent.
Emits a event for the child property on .
Emits a event for the child property on .
PropertySystem.ObsoleteGtk.RequisitionObtains the widget's requisition.a
Obtains requisition, unless someone has forced a particular geometry, in which case it returns that geometry instead of the widget's requisition. This method differs from in that it retrieves the last size request value, while the method recomputes the size request and fills in the requisition, and then returns the recomputed value.
PropertySystem.BooleanSets or obtains whether should be mapped along with its when its parent is mapped and has been shown with .Returns if the is mapped with the parent.
The child visibility can be set for before it is added to a container with , to avoid mapping children unnecessary before immediately unmapping them. However it will be reset to its default state of when the is removed from a container.
Note that changing the child visibility of a does not queue a resize on the . Most of the time, the size of a is computed from all visible children, whether or not they are mapped. If this is not the case, the container can queue a resize itself. This property is only useful for container implementations and never should be called by an application.
MethodSystem.ObsoleteSystem.Void
Location to store the length of the class path. or .
Location to store the class path as an allocated string, or .
Location to store the reverse class path as an allocated string, or .
Same as , but always uses the name of a 's type, never uses a custom name set with .PropertyGLib.Property("composite-child")System.BooleanWhether the is part of a composite widget. if the is part of a composite widget.EventGLib.Signal("composited-changed")System.EventHandlerRaised with the composited status changes.PropertySystem.StringSets or obtains a composite name.The composite name of , or if is not a composite child. The string should not be freed when it is no longer needed.
The must be a composite child of its parent; see .
MethodSystem.Boolean
To be added.
To be added.To be added.To be added.EventGLib.Signal("configure-event")Gtk.ConfigureEventHandlerRaised when the configuration of the window has changed (it has been moved or resized).MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodPango.ContextCreates a new with the appropriate colormap, font description, and base direction for drawing text for .The new .
See also .
MethodPango.Layout
text to set on the layout (can be ).
Creates a new with the appropriate colormap, font description, and base direction for drawing text for .The new .
If you keep a created in this way around, in order notify the layout of changes to the base direction or font of this , you must call in response to the and events for the .
EventGLib.Signal("damage-event")Gtk.DamageEventHandlerTo be added.To be added.PropertyGtk.TextDirectionSets or obtains the default reading direction for .A .
Where the direction has not been explicitly set by .
PropertySystem.ObsoleteGtk.StyleObtains the default style used by all initially.Returns the default style. This object is owned by GTK+ and should not be modified or freed.
Returns the default style used by all initially.
EventGLib.Signal("delete-event")Gtk.DeleteEventHandlerRaised when the user has clicked on the "close" button in the window's frame (the button that is automatically set by the window manager).If the handler returns False, the widget will be destroyed (and the window closed), but if the handler returns True, nothing will be done. This is a good way to prevent the user from closing your application's window if there should be some cleanups first (like saving the document).
using System;
using Gtk;
class TestClose
{
public static void Main ()
{
// Init Gtk#
Application.Init ();
// Create window
Window win = new Window ("Test Close");
win.SetDefaultSize (300, 300);
// Add button
Button button = new Button ("Close Now");
button.Clicked += delegate { Application.Quit (); };
win.Add (button);
// Delete event
win.DeleteEvent += delegate (object o, DeleteEventArgs e)
{
// Cancel closing then the "Close"
// button of the window is pressed
e.RetVal = true;
};
// Show window and run
win.ShowAll ();
Application.Run ();
}
}
MethodSystem.VoidTo be added.To be added.EventGLib.Signal("destroy")System.EventHandlerTo be added.To be added.EventGLib.Signal("destroy-event")Gtk.DestroyEventHandlerRaised when this widget is destroyed.MethodSystem.Boolean
To be added.
To be added.To be added.To be added.PropertyGtk.TextDirectionSets or obtains the reading direction on a particular .The reading direction for the .
This direction controls the primary direction for containing text, and also the direction in which the children of a container are packed. The ability to set the direction is present in order so that correct localization into languages with right-to-left reading directions can be done. Generally, applications will let the default reading direction present, except for containers where the containers are arranged in an order that is explicitely visual rather than logical (such as buttons for text justification). If the direction is set none, then the value set by will be used.
EventGLib.Signal("direction-changed")Gtk.DirectionChangedHandlerRaised when the text direction for this widget is changed.PropertyGdk.DisplayObtains the for the toplevel window associated with this .The for the toplevel for this .
This method can only be called after the has been added to a widget hierarchy with a at the top.
In general, you should only create display specific resources when a has been realized, and you should free those resources when the is unrealized.
MethodSystem.Void
To be added.
To be added.To be added.PropertyGLib.Property("double-buffered")System.BooleanUse this property to turn off the double buffering.Returns because double buffering is on by Default, but returns if you turn it off.
Widgets are double buffered by default, you can use this property to turn off the buffering. "Double buffered" simply means that and are called automatically around events sent to the . diverts all drawing to a 's window to an offscreen buffer, and draws the buffer to the screen. The result is that users see the window update in one smooth step, and don't see individual graphics primitives being rendered.
In very simple terms, double buffered don't flicker, so you would only use this property to turn off double buffering if you had special needs and really knew what you were doing.
EventGLib.Signal("drag-begin")Gtk.DragBeginHandlerRaised on a source widget when the user begins a drag.To be added.EventGLib.Signal("drag-data-delete")Gtk.DragDataDeleteHandlerRaised on a source widget when dragged data is deleted.EventGLib.Signal("drag-data-get")Gtk.DragDataGetHandlerRaised when the drag-and-drop process gets data from a source widget.EventGLib.Signal("drag-data-received")Gtk.DragDataReceivedHandlerRaised on a destination widget when it receives dragged data.EventGLib.Signal("drag-drop")Gtk.DragDropHandlerRaised on a source widget when dragged data is dropped.EventGLib.Signal("drag-end")Gtk.DragEndHandlerRaised on a source widget when a drag operation is completed.EventGLib.Signal("drag-failed")Gtk.DragFailedHandlerTo be added.To be added.EventGLib.Signal("drag-leave")Gtk.DragLeaveHandlerRaised when a drag action leaves this widget.EventGLib.Signal("drag-motion")Gtk.DragMotionHandlerRaised on a source widget when the user is moving a dragged selection.MethodSystem.Void
To be added.
To be added.To be added.EventGLib.Signal("draw")Gtk.DrawnHandlerTo be added.To be added.MethodSystem.ObsoleteSystem.VoidEnsures that has a style (->style).
Not a very useful method; most of the time, if you want the style, the is realized, and realized are guaranteed to have a style already.
EventGLib.Signal("enter-notify-event")Gtk.EnterNotifyEventHandlerThe pointer has just entered the widget.If the flag is set, Widget will gain the focus, and the widget might be drawn differently. If the handler returns False, the event might be passed to the parent of widget (if no other handler of widget has returned True).MethodSystem.VoidTo be added.To be added.PropertyGLib.Property("events")Gdk.EventMaskObtains or sets the event mask for the (a bitfield containing flags from ).a
The event mask determines which events a will receive. Keep in mind that different widgets have different default event masks, and by changing the event mask you may disrupt a 's fuctionalit, so be careful.
This property must be called while a is unrealized. Consider for widgets that are already realized, or if you want to preserve the existing event mask.
This property can't be used with widgets; to get events on those events, place them inside a and receive events on the event box.
These are the events that the will receive.
PropertyGLib.Property("expand")System.BooleanTo be added.To be added.To be added.EventGLib.Signal("focus")Gtk.FocusedHandlerRaised whenever this widget is focused.The widget gets this signal as the user uses keyboard shortcuts or tabs through the widgets in a window.EventGLib.Signal("grab-focus")System.EventHandlerRaised when this widget grabs the keyboard focus.EventGLib.Signal("focus-in-event")Gtk.FocusInEventHandlerRaised when the widget has just gained the focus.PropertySystem.Int32The width of the focus line in a .a
Subclasses of use this style property to correctly layout their children.
EventGLib.Signal("focus-out-event")Gtk.FocusOutEventHandlerRaised when the focus leaves this widget.MethodSystem.VoidStops emission of events on .
The events are queued until is called on .
PropertySystem.Obsolete("Replaced by Window property.")Gdk.WindowObtains or sets the underlying Gdk.Window used to display the contents of the .a MethodGtk.Widget
Ancestor type.
Obtains the first ancestor of .The ancesor , or see if not found.
For example sending gets the first that's an ancstor of . No reference will be added to the retured ; it should not be unreferenced. See note about checking for a toplevel in the docs for . Note that unlike , considers to be an ancestor of itself.
MethodGtk.Clipboard
A which identifies the clipboard to use. gives the default clipboard, another common value is , which gives the primary X selection.
Returns the clipboard object for the given selection to be used with .The appropiate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent for all time. must have a associated with it, so must be attached to a toplevel window.
MethodSystem.Boolean
To be added.
To be added.To be added.To be added.MethodGdk.EventMask
To be added.
To be added.To be added.To be added.MethodSystem.Void
Return location for the X coordinate, or .
Return location for the Y coordinate, or .
Obtains the location of the mouse pointer in coordinates.
Widget coordinates are a bit odd; for historical reasons, they are defined as ->window coordinates for widgets that are not , and are relative to ->allocation.x, ->allocation.y for widgets that are .
MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.
To be added.To be added.MethodSystem.Void
Return location for width, or .
Return location for height, or .
Gets the size request that was explicitly set for the using .
A value of -1 stored in or indicates that that dimension has not been set explicitly and the natural requisition of the will be used intead. See . To get the size a will actually use, call instead of this method.
EventGLib.Signal("grab-broken-event")Gtk.GrabBrokenEventHandlerRaised when an existing grab is broken by another.MethodSystem.VoidCauses to become the default .
The default is activated when the user presses Enter in a window. Default must be activatable, that is, should affect them. The must have the flag set; typically you have to set this flag yourself by calling .
MethodSystem.VoidCauses a to have the keyboard focus for the it's inside.
The must be a focusable , such as a ; something like won't work (More precisely, it must have the flag set).
EventGLib.Signal("grab-notify")Gtk.GrabNotifyHandlerEmitted when a widget grabs focus.PropertyGLib.GTypeGType Property.a Returns the native value for .PropertyGLib.Property("halign")Gtk.AlignTo be added.To be added.To be added.PropertyGLib.Property("has-default")System.Boolean when the currently is receiving the default action.Evaluates to if the currently is receiving the default action.When the is focused will receive the default action, and HasDefault will be even if there is a different widget set as default.PropertyGLib.Property("has-focus")System.BooleanWhether the has the input focus. if the has the input focus.PropertySystem.BooleanConvenience property to check Flags for WidgetFlags.HasGrabTrue if the HasGrab flag is set.None.PropertySystem.ObsoleteSystem.BooleanTo be added.To be added.To be added.PropertySystem.BooleanChecks whether there is a is associated with this .see langword="true" /> if there is a associated with the .All toplevel have an associated screen, and all added into a hierarchy with a toplevel window at the top.PropertyGLib.Property("has-tooltip")System.BooleanTo be added.To be added.To be added.PropertySystem.BooleanTo be added.To be added.To be added.PropertyGLib.Property("height-request")System.Int32Override for the height request for the .The height of the .Or -1 if natural request should be used.EventGLib.Signal("show-help")Gtk.HelpShownHandlerRaised when the help text is shown.PropertyGLib.Property("hexpand")System.BooleanTo be added.To be added.To be added.PropertyGLib.Property("hexpand-set")System.BooleanTo be added.To be added.To be added.EventGLib.Signal("hide")System.EventHandlerRaised whenever this widget is hidden.To be added.MethodSystem.VoidReverses the effects of , causing the to be hidden (invisible to the user).
Reverses the effects of , causing the to be hidden (invisible to the user).
MethodSystem.BooleanUtility method; intended to be connected to the event on a .Returns .
The method calls on its argument, then returns . If connected to , the result is that clicking the close button for a window (on the window frame, top right corner usually) will hide but not destroy the window. By default, GTK+ destroys windows when is received.
EventGLib.Signal("hierarchy-changed")Gtk.HierarchyChangedHandlerRaised when the hierarchy (parent or child relationships) of this widget or its parent or children changes.MethodSystem.BooleanTo be added.To be added.To be added.MethodSystem.Void
To be added.
To be added.To be added.MethodSystem.Boolean
A rectangle.
A rectangle to store intersection of and .
Computes the intersection of a 's area and . if there was an intersection.
Computes the intersection of a 's area and , storing the intersection in , and returns if there was an intersection. may be if you're only interested in whether there was an intersection.
MethodSystem.Boolean
Another .
Determines whether is somewhere inside , possibly with intermediate containers.Returns if ancestor contains as a child, grandchild, great grandchild, etc.
Determines whether is somewhere inside , possibly with intermediate containers.
PropertySystem.BooleanIndicates if a widget can rely on its alpha channel being drawn correctly.if , alpha compositing is available.Depends on window manager feature availability on X.PropertySystem.BooleanConvenience property to check if the widget is Visible and Realized.True if the widget is able to be drawn onNonePropertyGLib.Property("is-focus")System.BooleanDetermines if the is the focus widget within its toplevel. if the is the focus widget.
This does not mean that the flag is necessarily set; will only be set if the toplevel additionally has the global input focus.
PropertySystem.BooleanCheck to see if the widget is Mappedtrue if the widget is Mapped, false otherwise.None.PropertySystem.BooleanChecks to see if the widget is Realizedreturns true if the widget is RealizedNone.PropertySystem.BooleanTo be added.To be added.To be added.PropertySystem.BooleanTo be added.To be added.To be added.MethodSystem.Boolean
To be added.
To be added.To be added.To be added.EventGLib.Signal("key-press-event")Gtk.KeyPressEventHandlerRaised when a key is pressed within this widget.EventGLib.Signal("key-release-event")Gtk.KeyReleaseEventHandlerRaised when a key is released within this widget.EventGLib.Signal("leave-notify-event")Gtk.LeaveNotifyEventHandlerRaised when the mouse leaves this widget.MethodGtk.Widget[]Returns a list of the widgets, normally Labels, for which this widget is a the target of a mnemonica MethodSystem.VoidCauses a to be mapped if it isn't already.
This method is only for use in widget implementations.
EventGLib.Signal("map-event")Gtk.MapEventHandlerRaised just after the widget is mapped.EventGLib.Signal("map")System.EventHandlerRaised when this widget is mapped.PropertyGLib.Property("margin")System.Int32To be added.To be added.To be added.PropertyGLib.Property("margin-bottom")System.Int32To be added.To be added.To be added.PropertyGLib.Property("margin-left")System.Int32To be added.To be added.To be added.PropertyGLib.Property("margin-right")System.Int32To be added.To be added.To be added.PropertyGLib.Property("margin-top")System.Int32To be added.To be added.To be added.MethodSystem.Boolean
A boolean; set to true if the list of targets should cycle once the end of the list is reached.
Activates the targets associated with the mnemonic. if the activation is done.EventGLib.Signal("mnemonic-activate")Gtk.MnemonicActivatedHandlerRaised when someone presses a mnemonic key.PropertySystem.ObsoleteGtk.RcStyleObtains the current modifier style for the .(As set by )The modifier style for the . This rc style is owned by the .
If no style has previously set, a new will be created with all values unset, and set as the modifier style for the . If you make changes to this rc style, you must call , passing in the returned rc style, to make sure that your changes take effect.
Caution: passing the style back to will normally end up destroying it, because copies the passed-in style and sets the copy as the new modifier style, thus dropping any reference to the old modifier style. Add a reference to the modifier style if you want to keep it alive.
MethodSystem.Void
The state to be reset.
Resets the base color to the default color.To set a specific color, use the overload of this method.MethodSystem.ObsoleteSystem.Void
The state for which to set the base color.
The color to assign (does not need to be allocated), or to undo the effect of previous calls to of .
Sets the base color for a in a particular state.
All other style values are left untouched. The base color is the background color used along with the text color (see ) for such as and . See also .
MethodSystem.Void
The state to be reset.
Resets the background color to the default color.To set a specific color, use the overload of this method.MethodSystem.ObsoleteSystem.Void
The state for which to set the background color.
The color to assign (does not need to be allocated), or to undo the effect of previous calls of .
Sets the background color for a in a particular state.
All other style values are left untouched. See also .
MethodSystem.ObsoleteSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
The state to be reset.
Resets the foreground color to the default color.To set a specific color, use the overload of this method.MethodSystem.ObsoleteSystem.Void
The state for which to set the background color.
The color to assign (does not need to be allocated), or to undo the effect of previous calls to of .
Sets the foreground for a in a particular .
All other style values are left untouched. See also .
MethodSystem.ObsoleteSystem.Void
The font description to use, or to undo the effect of previous calls to .
Sets the font to use for a .
All other style values are left untouched. See also .
To change the font of a simple Widget:
using Pango;
...
[Widget] Label label1;
...
...
label1.ModifyFont(FontDescription.FromString("Courier 16"));
...
MethodSystem.ObsoleteSystem.Void
The holding the style modifications.
Modifies style values on the .
Modifications made using this technique take precedence over style values set via an RC file, however, they will be overriden if a is explicitely set on the using . The structure is designed so each field can either be set or unset, so it is possible, using this method, to modify some style values and leave the others unchanged.
Note that modifications made with this method are not cumulative with previous calls to or with such methods as . If you wish to retain previous values, you must first call , make your modifications to the returned , then call with that . On the other hand, if you first call , subsequent calls to such methods will have a cumulative effect with the initial modifications.
MethodSystem.Void
The state to be reset.
Resets the text color to the default color.To set a specific color, use the overload of this method.MethodSystem.ObsoleteSystem.Void
The state for which to set the text color.
The color to assign (does not need to be allocated), or to undo the effect of previous calls to of .
Sets the text for a in a particular state.
All other style values are left untouched. The text color is the foreground color used along with the base color (see ) for such as and . See also .
EventGLib.Signal("motion-notify-event")Gtk.MotionNotifyEventHandlerRaised when the pointer moves within this widget.EventGLib.Signal("move-focus")Gtk.MoveFocusHandlerTo be added.To be added.PropertyGLib.Property("name")System.StringThe name of the .The name of the .PropertyGLib.Property("no-show-all")System.Boolean
This property determines whether the widget will be affected by
and .
a , true if the widget should be affectedMethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideAccelCanActivate", Type=typeof(Gtk.Widget))System.Boolean
a , a signal ID
Method raised when the
event happens; override this for additional functionality.
a , true if the accelerator can be activated.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideAccelClosuresChanged", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="ConnectActivate", Type=typeof(Gtk.Widget))System.VoidMethod raised when the widget is activated, primarily by .Override this method in a subclass to be notified when the widget is activated, commonly when the user presses Enter or Space during key navigation.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideAdjustSizeAllocation", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideAdjustSizeRequest", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideButtonPressEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideButtonReleaseEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideChildNotified", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideCompositedChanged", Type=typeof(Gtk.Widget))System.VoidDefault handler for event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideComputeExpand", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideConfigureEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDamageEvent", Type=typeof(Gtk.Widget))System.Boolean
To be added.
To be added.To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDeleteEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDestroyed", Type=typeof(Gtk.Widget))System.VoidTo be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDestroyEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDirectionChanged", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDispatchChildPropertiesChanged", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragBegin", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragDataDelete", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragDataGet", Type=typeof(Gtk.Widget))System.Void
a
a
a
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragDataReceived", Type=typeof(Gtk.Widget))System.Void
a
a
a
a
a
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragDrop", Type=typeof(Gtk.Widget))System.Boolean
a
a
a
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragEnd", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragFailed", Type=typeof(Gtk.Widget))System.Boolean
To be added.
To be added.
To be added.To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragLeave", Type=typeof(Gtk.Widget))System.Void
a
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDragMotion", Type=typeof(Gtk.Widget))System.Boolean
a
a
a
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideDrawn", Type=typeof(Gtk.Widget))System.Boolean
To be added.
To be added.To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideEnterNotifyEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideFocused", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideFocusGrabbed", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideFocusInEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideFocusOutEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGetAccessible", Type=typeof(Gtk.Widget))Atk.ObjectTo be added.To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGetPreferredHeight", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGetPreferredHeightForWidth", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGetPreferredWidth", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGetPreferredWidthForHeight", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGetRequestMode", Type=typeof(Gtk.Widget))Gtk.SizeRequestModeTo be added.To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGrabBrokenEvent", Type=typeof(Gtk.Widget))System.Boolean
To be added.
Default handler for the event.To be added.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideGrabNotify", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideHelpShown", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideHidden", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideHierarchyChanged", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideKeyPressEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideKeyReleaseEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideLeaveNotifyEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideMapEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideMapped", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideMnemonicActivated", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideMotionNotifyEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideMoveFocus", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideParentSet", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverridePopupMenu", Type=typeof(Gtk.Widget))System.BooleanDefault handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverridePropertyNotifyEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideProximityInEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideProximityOutEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideQueryTooltip", Type=typeof(Gtk.Widget))System.Boolean
To be added.
To be added.
To be added.
To be added.
To be added.To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideRealized", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideScreenChanged", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideScrollEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideSelectionClearEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideSelectionGet", Type=typeof(Gtk.Widget))System.Void
a
a
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideSelectionNotifyEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideSelectionReceived", Type=typeof(Gtk.Widget))System.Void
a
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideSelectionRequestEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideShowAll", Type=typeof(Gtk.Widget))System.VoidTo be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideShown", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideSizeAllocated", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideStateChanged", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideStateFlagsChanged", Type=typeof(Gtk.Widget))System.Void
To be added.
To be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideStyleSet", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideStyleUpdated", Type=typeof(Gtk.Widget))System.VoidTo be added.To be added.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideUnmapEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideUnmapped", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideUnrealized", Type=typeof(Gtk.Widget))System.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideVisibilityNotifyEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideWidgetEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideWidgetEventAfter", Type=typeof(Gtk.Widget))System.Void
a Default handler for the event.Override this method in a subclass to provide a default handler for the event.MethodGLib.DefaultSignalHandler(ConnectionMethod="OverrideWindowStateEvent", Type=typeof(Gtk.Widget))System.Boolean
a Default handler for the event.a Override this method in a subclass to provide a default handler for the event.MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.To be added.PropertyPango.ContextObtains a with the appropriate colormap, font description and base direction for .
Unlike the context returned by , this context is owned by the (it can be used until the screen for the changes or the is removed from its toplevel), and will be updated to match any changes to the 's attributes.
If you create and keep a using this context, you must deal with changes to the context by calling on the layout in response to the and events for the .
PropertyGLib.Property("parent")Gtk.WidgetThe parent widget of this .The parent widget.Must be a Container ,EventGLib.Signal("parent-set")Gtk.ParentSetHandlerRaised whenever this widget's parent widget is set.PropertyGdk.WindowSets or obtains 's parent window.The parent window of .
Sets or obtains 's parent window.
MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.ObsoleteSystem.Void
Location to store length of the path, or .
Location to store allocated path string, or .
Location to store allocated reverse path string, or .
Obtains the full path to .
The path is simply the name of a and all its parents in the container hierarchy, separated by periods. The name of a comes from . Paths are used to apply styles to a in gtkrc configuration files. Widget names are the type of the by default (e.g. "") or can be set to an application-specific value with .
By setting the name of a , you allow users or theme authors to apply styles to that specific in their gtkrc file. fills in the path in reverse order, i.e. starting with 's name instead of starting with the name of 's outermost ancestor.
MethodSystem.VoidCancels the effect of a previous call to .
Cancels the effect of a previous call to .
EventGLib.Signal("popup-menu")Gtk.PopupMenuHandlerRaised when this widget's popup menu is activated.MethodSystem.Boolean
A .
Rarely-used method. This method is used to emit the events on a .Return from the event emission ( if the event was handled)
If you want to synthesize an event though, don't use this method; instead, use Gtk.Main.DoEvent so the event will behave as if it were in the event queue.
EventGLib.Signal("property-notify-event")Gtk.PropertyNotifyEventHandlerEmitted when a property is changed.EventGLib.Signal("proximity-in-event")Gtk.ProximityInEventHandlerRaised when the user is using a stylus or touch screen and their pointer comes near the widget.See for context.EventGLib.Signal("proximity-out-event")Gtk.ProximityOutEventHandlerRaised when the user is using a stylus or touch screen and their pointer leaves the area near the widget.See for context.MethodSystem.VoidMakes all newly-created as composite children until the corresponding call.
A composite child is a child that's an implementation detail of the container it's inside and should not be visible to people using the container. Composite children aren't treated differently by GTK# (but see vs. ), but e.g. GUI builders might want to treat them in a different way.
EventGLib.Signal("query-tooltip")Gtk.QueryTooltipHandlerTo be added.To be added.MethodSystem.VoidTo be added.To be added.MethodSystem.VoidEquivalent to calling for the entire area of a .
Equivalent to calling for the entire area of a .
MethodSystem.Void
y coordinate of upper-left corner of rectangle to redraw.
x coordinate of upper-left corner of rectangle to redraw.
Width of region to draw.
Height of region to draw.
Invalidates the rectangular area of a .
Invalidates the rectangular area of defined by , , and by calling on the 's window and all its child windows. Once the main loop becomes idle (after the current batch of events has been processed, roughly), the window will receive events for the union of all regions that have been invalidated.
Normally you would only use this method in widget implementations. You might also use it, or directly, to schedule a redraw of a or some portion thereof. Frequently you can just call or instead of this method. Those methods will invalidate only a single window, instead of the and all its children.
The advantage of adding to the invalidated region compared to simply drawing immediately is efficiency; using an invalid region ensures that you only have to redraw one time.
If an immediate redraw is desired, a call to will force an immediate refresh of the drawable. This can be useful in situations where mouse activity requires immediate visible feedback on the widget.
MethodSystem.Void
To be added.
To be added.To be added.MethodSystem.VoidFlags a to have its size renegotiated; should be called when a for some reason has a new .
This method is only for use in widget implementations. One example, when you change the text in a , it queues a resize to ensure there's enough space for the new text.
MethodSystem.VoidThis function works like , except that the widget is not invalidated.PropertySystem.IntPtrTo be added.To be added.To be added.MethodSystem.VoidCreates the GDK (windowing system) resources associated with a .
For example, ->window will be created when a is realized. Normally realization happens implicitly; if you show a and all its parent containers, then it will be realized and mapped automatically. Realizing a requires all the widget's parent widgets to be realized; calling realizes the widget's parents in addition to itself. If a is not yet inside a toplevel window when you realize it, bad things will happen.
This method is primarily used in widget implementations, and isn't very useful otherwise. Many times when you think you might need it, a better approach is to connect to a event that will be called after the is realized automatically, such as . Or simply to the realize event.
EventGLib.Signal("realize")System.EventHandlerEmitted when a widget is realized.The default handler creates the Gdk window associated with the widget, and its ancestors.PropertyGLib.Property("receives-default")System.BooleanWhether to make the receive the default action when it is focused. if the will receive the default action when is focused.PropertySystem.BooleanSets whether a size allocation changes, the entire is queued for drawing.Returns because it is on by Default, but returns if you turn it off.
By default, this setting is and the entire is redrawn on every size change. If your leaves the upper left are unchanged when made bigger, turning this setting on will improve performance.
Note that for setting this flag to turns off all allocation on resizing: the will not even redraw if its position changes; this is to allow containers that don't draw anything to avoid excess invalidations. If you set this flag on a that does draw on ->window, you are responsible for invalidating both the old and new allocation of the when the is moved and responsible for invalidating regions newly when the increases size.
MethodAtk.ObjectGets a reference to an object's implementation.An .
Gets a reference to an object's implementation.
MethodCairo.Region
To be added.
To be added.To be added.To be added.MethodSystem.Boolean
Accel group for this .
GDK keyval of the accelerator.
Modifier key combination of the accelerator.
Removes an accelerator from , previously installed with .Returns whether an accelerator was installed and could be removed.
Removes an accelerator from , previously installed with .
MethodSystem.Void
a Removes a widget from the list of mnemonic labels for this widget.The widget must have previously been added to the list with .MethodSystem.ObsoleteGdk.Pixbuf
A stock ID.
A stock size.
Render detail to pass to theme engine.
A convenience method that uses the theme engine and RC file settings for to look up and render it to a .A new , or if the wasn't known.
The should be a stock icon ID such as or . should be a size such as . should be a string that identifies the or code doing the rendering, so that theme engines can special-case rendering for that or code.
The pixels in the returned are shared with the rest of the application and should not be modified. The should be freed after use with .
MethodGdk.Pixbuf
To be added.
To be added.
To be added.To be added.To be added.MethodSystem.Void
A to move the into.
Moves a from one to another, handling reference count issues to avoid destroying the .
Moves a from one to another, handling reference count issues to avoid destroying the .
PropertyGtk.SizeRequestModeTo be added.To be added.To be added.PropertyGtk.RequisitionGets or Sets the widget's requisitiona representing the widget's requisitionMethodSystem.ObsoleteSystem.VoidReset the styles of and all descendents, so when they are looked up again, they get the correct values for the currently loaded RC file settings.
This method is not useful for applications.
MethodSystem.VoidTo be added.To be added.PropertyGdk.WindowThe root window this Widget is attached to.a PropertyGdk.ScreenObtains the from the toplevel window associated with this .The for the toplevel for this .
This method can only be called after the has been added to a widget hierarchy with a at the top.
In general, you should only create screen specific resources when a has been realized, and you should free those resources when the is unrealized.
EventGLib.Signal("screen-changed")Gtk.ScreenChangedHandlerEmitted when the screen has changed.EventGLib.Signal("scroll-event")Gtk.ScrollEventHandlerRaised when the widget is scrolled.EventGLib.Signal("selection-clear-event")Gtk.SelectionClearEventHandlerRaised when the current selection is cleared.EventGLib.Signal("selection-get")Gtk.SelectionGetHandlerRaised when this widget gets a selection from the clipboard.EventGLib.Signal("selection-notify-event")Gtk.SelectionNotifyEventHandlerEmitted when a selection is made.EventGLib.Signal("selection-received")Gtk.SelectionReceivedHandlerRaised when this widget is the destination of a received selection.EventGLib.Signal("selection-request-event")Gtk.SelectionRequestEventHandlerRaised whenever the widget receives a request for a selection.TODO: explain more about the X selection model MethodSystem.Int32
A .
Very rarely-used method. This method is used to emit an events on a .Return from the event emission ( if the event was handled).
This method is not normally used directly. The only time it is used is when propagating an to a child , and that is normally done using . If you want to force an area of a window to be redrawn, use or . To cause the redraw to be done immediately, follow that call with a call to .
MethodSystem.Boolean
To be added.
To be added.To be added.To be added.PropertyGLib.Property("sensitive")System.BooleanSets the sensitivity of the . A widget is sensitive if the user can interact with it, otherwise, it is grayed. if the responds to input.Insensitive widgets are "grayed out" and the user can't
interact with them. Insensitive widgets are known as
"inactive", "disabled", or "ghosted" in some other toolkits.
The sensitivity of a widget determines whether it will receive
certain events (e.g. button or key presses).
If the ancestor (parent) widget sesitivity is set to false,
it does not matter what the sensitivity property have,
the widget will not be sensitive. Use
widget.Parent.Sensitive
to check whether the ancestor widget is sensitive or not.
When the sensitive property is set to false, the widget
property will return false.
MethodSystem.Void
Path used to look up the the accelerator.
A .
Given an accelerator group, , and an accelerator path, , sets up an accelerator in so whenever the key binding that is defined for is pressed, will be activated.
This removes any accelerators (for any accelerator group) installed by previous calls to . Associating accelerators with paths allows them to be modified by the user and the modifications to be saved for future use.
This is a low level method that would most likely be used by a menu creation system like . If you use , setting up accelerator paths will be done automatically.
MethodSystem.Void
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Void
Width should request, or -1 to unset.
Weight should request, or -1 to unset.
Sets the minimum size of a ; that is, the 's size request will be by .
You can use this method to force a to be either larger or smaller than it normally would be. In most cases, is a better choice for toplevel windows than this method; setting the default size will still allow users to shrink the window. Setting the size request will force them to leave the window at least as large as the size request. When dealing with window sizes, can be a useful method as well.
Note the inherent danger of setting any fixed size - themes, translations into other languages, different fonts, and user action can all change the appropriate size for a given . So, it's basically impossible to hardcode a size that will always be correct. The size request of a is the smallest size a can accept while still methoding well and drawing itself correctly. However in some strange cases a may be allocated less than its requested size, and in many cases a may be allocated more space than it requested.
MethodSystem.Void
To be added.
To be added.
To be added.To be added.PropertyGtk.SettingsObtains the settings object holding the settings (global property settings, RC file information, etc) used for this .The relevant object.
Note that this property can only be called when the is attached to a toplevel, since the settings object is specific to a particular .
MethodSystem.Void
To be added.
To be added.To be added.MethodSystem.VoidFlags a to be displayed.
Any that isn't shown will not appear on the screen. If you want to show all the in a container, it's easier to call on the container, instead of individually showing the .
Remember that you have to show the containers containing a , in addition to the itself, before it will appear onscreen. And that when a toplevel container is shown, it is immediately realized and mapped; other shown are realized and mapped when their toplevel container is realized and mapped.
MethodSystem.VoidRecursively shows a , and any child (if the widget is a container).
Recursively shows a , and any child (if the widget is a container).
EventGLib.Signal("show")System.EventHandlerRaised when the widget is shown.MethodSystem.VoidShows a .
If the is an unmapped toplevel , a that has not yet been shown, enter the main loop and wait for the window to actually be mapped. Be careful, because the main loop is running, anything can happen during this method.
MethodSystem.Void
A position and size to be allocated to .
This method is only used by subclasses, to assign a size and position to their child .
This fuction is only used by subclasses, to assign a size and position to their child .
EventGLib.Signal("size-allocate")Gtk.SizeAllocatedHandlerRaised when size is allocated for this widget.MethodSystem.ObsoleteGtk.RequisitionObtains the preferred size of a .a
The container uses this information to arrange its child widgets and decide what size allocations to give them with .
You can also call this method from an application, with some caveats. Most notably, getting a size request requieres the 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 will actually be allocated.
PropertyGtk.StateTypeSets or obtains the state of a (insensitive, prelighted, etc.).New state for .Usually you should set the state using wrapper fuctions such as . This property is for use in widget implementations. This property should not be used to check the state of a Gtk.Checkbutton or Gtk.ToggleButton, use .EventGLib.Signal("state-changed")Gtk.StateChangedHandlerRaised when the state of the widget changes.See for the possible states of a widget.PropertyGtk.StateFlagsTo be added.To be added.To be added.EventGLib.Signal("state-flags-changed")Gtk.StateFlagsChangedHandlerTo be added.To be added.PropertyGLib.Property("style")System.ObsoleteGtk.StyleThe style of the .A style.Which contains information about how it will look (colors etc).MethodSystem.ObsoleteSystem.VoidTo be added.To be added.PropertyGtk.StyleContextTo be added.To be added.To be added.MethodSystem.Object
The name of a style property.
Obtains the value of a style property of .The property value. This can be one of the following types: , , , , ,
, , , ,
or .EventGLib.Signal("style-set")Gtk.StyleSetHandlerRaised when a is set for this widget.tEventGLib.Signal("style-updated")System.EventHandlerTo be added.To be added.PropertySystem.BooleanTo be added.To be added.To be added.MethodSystem.VoidReverts the effect of a previous call to .
Reverts the effect of a previous call to . This causes all queued events on to be emitted.
PropertyGLib.Property("tooltip-markup")System.StringTo be added.To be added.To be added.PropertyGLib.Property("tooltip-text")System.StringTo be added.To be added.To be added.PropertyGtk.WindowTo be added.To be added.To be added.PropertyGtk.WidgetObtains the topmost in the container hierarchy is a part of.The topmost ancestor of , or itself if there's no ancestor.
Note the difference in behavior against , would return if wasn't inside a toplevel window, and if the window was inside a GtkWindow-derived which was in turn inside the toplevel . While the second case may seem unlikely, it actually happens when a is embedded inside a within the same application. To reliably find the toplevel , use and check if the flag is set on the result.
MethodSystem.Boolean
A .
X position relative to source .
Y position relative to source .
Location to store X position relative to .
Location to store Y position relative to .
Translate coordinates relative to 's allocation to coordinates relative to 's allocations.Returns if either was not realized, or there was no common ancestor. In this case, nothing is stored in and . Otherwise .
In order to perform this operation, both widgets must be realized, and must share a common toplevel.
MethodSystem.VoidTo be added.To be added.MethodSystem.VoidCauses a to be unmapped if it's currently mapped.
This method is only for use in widget implementations.
EventGLib.Signal("unmap-event")Gtk.UnmapEventHandlerRaised whenever this widget (or its parent, if is true for the parent) is told to hide itself.EventGLib.Signal("unmap")System.EventHandlerRaised when the widget is unmapped on the screen.MethodSystem.VoidShould be called by implementations of the remove method on , to dissociate a child from the container.
This method is only for use in widget implementations.
MethodSystem.VoidCauses a to be unrealized (frees all GDK resources associated with the widget).
This method is only useful in widget implementations.
EventGLib.Signal("unrealize")System.EventHandlerRaised when a widget is unrealized.MethodSystem.Void
To be added.
To be added.To be added.PropertyGLib.Property("valign")Gtk.AlignTo be added.To be added.To be added.PropertyGLib.Property("vexpand")System.BooleanTo be added.To be added.To be added.PropertyGLib.Property("vexpand-set")System.BooleanTo be added.To be added.To be added.EventGLib.Signal("visibility-notify-event")Gtk.VisibilityNotifyEventHandlerRaised whenever the visibility state of the widget changes--- partially visible or fully visible, for example.It may be preferable to handle a instead.PropertyGLib.Property("visible")System.BooleanWhether the is visible. if the widget is meant to be visible.PropertyGdk.VisualObtains the visual that will be used to render .The visual for .
Obtains the visual that will be used to render .
EventGLib.Signal("event")Gtk.WidgetEventHandlerEmits the WidgetEvent.EventGLib.Signal("event-after")Gtk.WidgetEventAfterHandlerEmits the WidgetEventAfter.PropertyGtk.WidgetPathTo be added.To be added.To be added.PropertyGLib.Property("width-request")System.Int32Override for the width request for the .The width of the .Or -1 if natural request should be used.PropertyGLib.Property("window")Gdk.WindowTo be added.To be added.To be added.EventGLib.Signal("window-state-event")Gtk.WindowStateEventHandlerEmitted when the Window state changes.