GtkSharp/doc/en/Gtk/ToolItem.xml
John Luke 163cacb30f 2004-12-20 John Luke <john.luke@gmail.com>
* en/Gtk/Widget.xml: finish
        * en/Gtk/Window.xml: finish
        * en/Gtk/*.xml: random stuff, mostly enums

svn path=/trunk/gtk-sharp/; revision=38021
2004-12-21 04:08:27 +00:00

444 lines
No EOL
17 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>To be added</summary>
<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>