47484b5e24
* en/Gtk/Item.xml * en/Gtk/Input.xml * en/Gtk/ToolItem.xml * en/Gtk/UIManager.xml: Added docs. * en/Gtk/IMStatusStyle.xml * en/Gtk/IMPreeditStyle.xml * en/Gtk/IMContextInfo.xml: Marked "do not use" pending resolution of bug 71021. svn path=/trunk/gtk-sharp/; revision=38367
470 lines
18 KiB
XML
470 lines
18 KiB
XML
<Type Name="ToolItem" FullName="Gtk.ToolItem">
|
|
<TypeSignature Language="C#" Value="public class ToolItem : Gtk.Bin, Implementor, IWrapper, IDisposable" Maintainer="auto" />
|
|
<AssemblyInfo>
|
|
<AssemblyName>gtk-sharp</AssemblyName>
|
|
<AssemblyPublicKey>[00 24 00 00 04 80 00 00 94 00 00 00 06 02 00 00 00 24 00 00 52 53 41 31 00 04 00 00 01 00 01 00 71 EB 6C 55 75 52 9C BF 72 44 F7 A6 EA 05 62 84 F9 EA E0 3B CF F2 CC 13 2C 9C 49 0A B3 09 EA B0 B5 6B CE 44 9D F5 03 D9 C0 A8 1E 52 05 85 CD BE 70 E2 FB 90 43 4B AC 04 FA 62 22 A8 00 98 B7 A1 A7 B3 AF 99 1A 41 23 24 BB 43 25 F6 B8 65 BB 64 EB F6 D1 C2 06 D5 73 2D DF BC 70 A7 38 9E E5 3E 0C 24 6E 32 79 74 1A D0 05 03 E4 98 42 E1 9B F3 7B 19 8B 40 21 26 CB 36 89 C2 EA 64 96 A4 7C B4]</AssemblyPublicKey>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyCulture>neutral</AssemblyCulture>
|
|
<Attributes />
|
|
</AssemblyInfo>
|
|
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
|
|
<Docs>
|
|
<summary>Objects to fill a <see cref="T:Gtk.Toolbar" />.</summary>
|
|
<remarks />
|
|
</Docs>
|
|
<Base>
|
|
<BaseTypeName>Gtk.Bin</BaseTypeName>
|
|
</Base>
|
|
<Interfaces>
|
|
<Interface>
|
|
<InterfaceName>Atk.Implementor</InterfaceName>
|
|
</Interface>
|
|
<Interface>
|
|
<InterfaceName>GLib.IWrapper</InterfaceName>
|
|
</Interface>
|
|
<Interface>
|
|
<InterfaceName>System.IDisposable</InterfaceName>
|
|
</Interface>
|
|
</Interfaces>
|
|
<Attributes />
|
|
<Members>
|
|
<Member MemberName="Finalize">
|
|
<MemberSignature Language="C#" Value="protected override void Finalize ();" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Override for any actions required before object destruction.</summary>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="OnToolbarReconfigured">
|
|
<MemberSignature Language="C#" Value="protected virtual void OnToolbarReconfigured ();" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Default handler for the <see cref="M:Gtk.ToolItem.ToolbarReconfigured" /> event.</summary>
|
|
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.ToolItem.ToolbarReconfigured" /> event.</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="OnCreateMenuProxy">
|
|
<MemberSignature Language="C#" Value="protected virtual bool OnCreateMenuProxy ();" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Default handler for the <see cref="M:Gtk.ToolItem.CreateMenuProxy" /> event.</summary>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.ToolItem.CreateMenuProxy" /> event.</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="OnTooltipSet">
|
|
<MemberSignature Language="C#" Value="protected virtual bool OnTooltipSet (Gtk.Tooltips tooltips, string tip_text, string tip_private);" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="tooltips" Type="Gtk.Tooltips" />
|
|
<Parameter Name="tip_text" Type="System.String" />
|
|
<Parameter Name="tip_private" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<summary>Default handler for the <see cref="M:Gtk.ToolItem.TooltipSet" /> event.</summary>
|
|
<param name="tooltips">a <see cref="T:Gtk.Tooltips" /></param>
|
|
<param name="tip_text">a <see cref="T:System.String" /></param>
|
|
<param name="tip_private">a <see cref="T:System.String" /></param>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.ToolItem.TooltipSet" /> event.</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="SetProxyMenuItem">
|
|
<MemberSignature Language="C#" Value="public void SetProxyMenuItem (string menu_item_id, Gtk.Widget menu_item);" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="menu_item_id" Type="System.String" />
|
|
<Parameter Name="menu_item" Type="Gtk.Widget" />
|
|
</Parameters>
|
|
<Docs>
|
|
<summary>
|
|
Sets the <see cref="T:Gtk.MenuItem" /> used in the toolbar overflow menu.
|
|
</summary>
|
|
<param name="menu_item_id">a <see cref="T:System.String" /></param>
|
|
<param name="menu_item">a <see cref="T:Gtk.Widget" /></param>
|
|
<remarks>
|
|
The <paramref name="menu_item_id" /> is used to identify the caller of this function and
|
|
should also be used with <see cref="M:Gtk.ToolItem.GetProxyMenuItem" />.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="GetProxyMenuItem">
|
|
<MemberSignature Language="C#" Value="public Gtk.Widget GetProxyMenuItem (string menu_item_id);" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.Widget</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="menu_item_id" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<summary>
|
|
If <paramref name="menu_item_id" /> matches the string passed to
|
|
<see cref="M:Gtk.ToolItem.SetProxyMenuItem" />,
|
|
return the corresponding <see cref="T:Gtk.MenuItem" />.
|
|
|
|
</summary>
|
|
<param name="menu_item_id">a <see cref="T:System.String" /></param>
|
|
<returns>a <see cref="T:Gtk.Widget" /></returns>
|
|
<remarks>
|
|
Custom subclasses of <see cref="T:Gtk.ToolItem" /> should use this
|
|
function to update their menu item when the
|
|
<see cref="T:Gtk.ToolItem" /> changes. That the
|
|
<paramref name="menu_item_id" />s must match ensures that a
|
|
<see cref="T:Gtk.ToolItem" /> will not
|
|
inadvertently change a menu item that they did not create.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="SetTooltip">
|
|
<MemberSignature Language="C#" Value="public void SetTooltip (Gtk.Tooltips tooltips, string tip_text, string tip_private);" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="tooltips" Type="Gtk.Tooltips" />
|
|
<Parameter Name="tip_text" Type="System.String" />
|
|
<Parameter Name="tip_private" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<summary>
|
|
Sets the <see cref="T:Gtk.Tooltips" /> object to be used for
|
|
this tool item, the text to be displayed as tooltip on the
|
|
item and the private text to be used.
|
|
</summary>
|
|
<param name="tooltips">a <see cref="T:Gtk.Tooltips" /></param>
|
|
<param name="tip_text">a <see cref="T:System.String" />, the tooltip text for the item</param>
|
|
<param name="tip_private">a <see cref="T:System.String" />, the pricate text</param>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="RetrieveProxyMenuItem">
|
|
<MemberSignature Language="C#" Value="public Gtk.Widget RetrieveProxyMenuItem ();" />
|
|
<MemberType>Method</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.Widget</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
Returns the <see cref="T:Gtk.MenuItem" /> that was last set by
|
|
<see cref="M:Gtk.ToolItem.SetProxyMenuItem" />; that is, the
|
|
<see cref="T:Gtk.MenuItem" /> that is going to appear in the
|
|
overflow menu.
|
|
</summary>
|
|
<returns>a <see cref="T:Gtk.Widget" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="C#" Value="protected ToolItem (GLib.GType gtype);" />
|
|
<MemberType>Constructor</MemberType>
|
|
<ReturnValue />
|
|
<Parameters>
|
|
<Parameter Name="gtype" Type="GLib.GType" />
|
|
</Parameters>
|
|
<Docs>
|
|
<summary>Protected constructor.</summary>
|
|
<param name="gtype">a <see cref="T:GLib.GType" /></param>
|
|
<returns>a <see cref="T:Gtk.ToolItem" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="C#" Value="public ToolItem (IntPtr raw);" />
|
|
<MemberType>Constructor</MemberType>
|
|
<ReturnValue />
|
|
<Parameters>
|
|
<Parameter Name="raw" Type="System.IntPtr" />
|
|
</Parameters>
|
|
<Docs>
|
|
<summary>Constructor for internal use. Do not use.</summary>
|
|
<param name="raw">a <see cref="T:System.IntPtr" />, pointer to the underlying C object.</param>
|
|
<returns>a <see cref="T:Gtk.ToolItem" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="C#" Value="public ToolItem ();" />
|
|
<MemberType>Constructor</MemberType>
|
|
<ReturnValue />
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Public constructor.</summary>
|
|
<returns>a <see cref="T:Gtk.ToolItem" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="GType">
|
|
<MemberSignature Language="C#" Value="public static GLib.GType GType { get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>GLib.GType</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>The <see cref="T:GLib.GType" /> of this object.</summary>
|
|
<returns>a <see cref="T:GLib.GType" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="VisibleHorizontal">
|
|
<MemberSignature Language="C#" Value="public bool VisibleHorizontal { set; get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Whether the toolbar item is visible when the toolbar is in a horizontal orientation.</summary>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="VisibleVertical">
|
|
<MemberSignature Language="C#" Value="public bool VisibleVertical { set; get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Whether the toolbar item is visible when the toolbar is in a vertical orientation.</summary>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="IsImportant">
|
|
<MemberSignature Language="C#" Value="public bool IsImportant { set; get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Whether the toolbar item is considered important.</summary>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks>
|
|
When TRUE, toolbar buttons show text when the toolbar is in
|
|
<see cref="T:Gtk.ToolbarStyle.BothHoriz" /> mode.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="ToolbarStyle">
|
|
<MemberSignature Language="C#" Value="public Gtk.ToolbarStyle ToolbarStyle { get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.ToolbarStyle</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>Sets some display styles for this toolbar; see
|
|
<see cref="T:Gtk.ToolbarStyle" /> for details. </summary>
|
|
<returns>a <see cref="T:Gtk.ToolbarStyle" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="Orientation">
|
|
<MemberSignature Language="C#" Value="public Gtk.Orientation Orientation { get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.Orientation</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>The orientation used for this tool item. See <see cref="T:Gtk.Orientation" />.</summary>
|
|
<returns>a <see cref="T:Gtk.Orientation" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="IconSize">
|
|
<MemberSignature Language="C#" Value="public Gtk.IconSize IconSize { get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.IconSize</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>The size of icons in this toolbar. See <see cref="T:Gtk.IconSize" />.</summary>
|
|
<returns>a <see cref="T:Gtk.IconSize" /></returns>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="UseDragWindow">
|
|
<MemberSignature Language="C#" Value="public bool UseDragWindow { set; get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
Whether this toolitem has a drag window.
|
|
</summary>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks>
|
|
When this is TRUE the toolitem can be used as a drag source through
|
|
<see cref="M:Gtk.Drag.SourceSet" />.
|
|
When this toolitem has a drag window it will intercept all events,
|
|
even those that would otherwise be sent to a child of the toolitem.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="ReliefStyle">
|
|
<MemberSignature Language="C#" Value="public Gtk.ReliefStyle ReliefStyle { get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.ReliefStyle</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
Returns the relief style of this toolitem. See <see cref="T:Gtk.ReliefStyle" />.
|
|
</summary>
|
|
<returns>a <see cref="T:Gtk.ReliefStyle" /></returns>
|
|
<remarks>
|
|
Custom subclasses of <see cref="T:Gtk.ToolItem" /> should call
|
|
this function in the handler
|
|
of the <see cref="E:Gtk.ToolItem.ToolbarReconfigured" /> signal
|
|
to find out the relief style of buttons.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="Expand">
|
|
<MemberSignature Language="C#" Value="public bool Expand { set; get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
Whether this toolitem is allocated extra space when there
|
|
is more room on the toolbar then needed for the items.
|
|
</summary>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks>
|
|
If true, the effect is that the item gets bigger when the
|
|
toolbar gets bigger and smaller when the toolbar gets smaller.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<see cref="T:Gtk.ReliefStyle" />
|
|
<Member MemberName="Homogeneous">
|
|
<MemberSignature Language="C#" Value="public bool Homogeneous { set; get; };" />
|
|
<MemberType>Property</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.Boolean</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
Whether this toolitem is to be allocated the same size as other
|
|
homogeneous items.
|
|
</summary>
|
|
<returns>a <see cref="T:System.Boolean" /></returns>
|
|
<remarks>
|
|
If true, the effect is that all homogeneous items will have
|
|
the same width as the widest of the items.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="ToolbarReconfigured">
|
|
<MemberSignature Language="C#" Value="public event EventHandler ToolbarReconfigured;" />
|
|
<MemberType>Event</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>System.EventHandler</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
This signal is emitted when some property of the toolbar that the
|
|
item is a child of changes.
|
|
</summary>
|
|
<remarks>
|
|
For custom subclasses of
|
|
<see cref="T:Gtk.ToolItem" />,
|
|
the default handler of this signal uses the properties
|
|
<see cref="P:Gtk.Toolbar.Orientation" />,
|
|
<see cref="P:Gtk.Toolbar.Style" />,
|
|
<see cref="P:Gtk.Toolbar.IconSize" />, and
|
|
<see cref="P:Gtk.Toolbar.ReliefStyle" />
|
|
to find out what the toolbar should look like and change
|
|
themselves accordingly.
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="CreateMenuProxy">
|
|
<MemberSignature Language="C#" Value="public event Gtk.CreateMenuProxyHandler CreateMenuProxy;" />
|
|
<MemberType>Event</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.CreateMenuProxyHandler</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
This event is fired when the toolbar is displaying an
|
|
overflow menu and is trying to determine if toolitem
|
|
should appear in the overflow menu.
|
|
</summary>
|
|
<remarks>
|
|
<para>
|
|
In response to this event, toolitems
|
|
should either call the <see
|
|
cref="Gtk.ToolItem.SetProxyMenuItem"/> method specifying
|
|
menu_item as None and return <see langword="true"/> to indicate that the
|
|
item should not appear in the overflow menu, OR call the
|
|
<see cref="Gtk.ToolItem.SetProxyMenuItem"/> method with a
|
|
new menu item and return <see langword="true"/>, OR
|
|
|
|
return <see langword="false"/> to indicate that the signal was not handled
|
|
by the item. This means that the item will not appear in the
|
|
overflow menu unless a later handler installs a menu item.
|
|
</para>
|
|
<para>
|
|
The toolbar may cache the result of this signal. When the
|
|
tool item changes how it will respond to this signal it
|
|
must call the rebuild_menu() method to invalidate the
|
|
cache and ensure that the toolbar rebuilds its overflow
|
|
menu.
|
|
</para>
|
|
<para>TODO: figure out why there is no rebuild_menu in gtk#</para>
|
|
</remarks>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="TooltipSet">
|
|
<MemberSignature Language="C#" Value="public event Gtk.TooltipSetHandler TooltipSet;" />
|
|
<MemberType>Event</MemberType>
|
|
<ReturnValue>
|
|
<ReturnType>Gtk.TooltipSetHandler</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<summary>
|
|
This signal is emitted when the toolitem's tooltip changes.
|
|
</summary>
|
|
<remarks />
|
|
</Docs>
|
|
</Member>
|
|
</Members>
|
|
</Type>
|