GtkSharp/doc/en/Gtk/MenuItem.xml

345 lines
13 KiB
XML
Raw Normal View History

<Type Name="MenuItem" FullName="Gtk.MenuItem">
<TypeSignature Language="C#" Value="public class MenuItem : Gtk.Item, Implementor, IWrapper, IWrapper, IDisposable" Maintainer="Hector Gomez M" />
<AssemblyInfo>
<AssemblyName>gtk-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>0.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>A widget used for items in menus.</summary>
<remarks>
<para>The <see cref="T:Gtk.MenuItem" /> and derived widgets are the only valid children for menus. Their function is to correctly handle highlighting, alignment, events and submenus.</para>
</remarks>
</Docs>
<Base>
<BaseTypeName>Gtk.Item</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>Atk.Implementor</InterfaceName>
</Interface>
<Interface>
<InterfaceName>GLib.IWrapper</InterfaceName>
</Interface>
<Interface>
<InterfaceName>GLib.IWrapper</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Attributes />
<Members>
<Member MemberName="RemoveSubmenu">
<MemberSignature Language="C#" Value="public void RemoveSubmenu ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Removes the submenu of the <see cref="T:Gtk.MenuItem" />, if it has one.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Deselect">
<MemberSignature Language="C#" Value="public void Deselect ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Fires the <see cref="F:Gtk.Item.Deselect" /> event.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Select">
<MemberSignature Language="C#" Value="public void Select ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Fires the <see cref="F:Gtk.Item.Select" /> event.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="ToggleSizeAllocate">
<MemberSignature Language="C#" Value="public void ToggleSizeAllocate (int allocation);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="allocation" Type="System.Int32" />
</Parameters>
<Docs>
<summary>Emits the <see cref="F:Gtk.MenuItem.ToggleSizeAllocated" /> event on the given item.</summary>
<param name="allocation">The allocation to use as signal data.</param>
<remarks />
</Docs>
</Member>
<Member MemberName="Activate">
<MemberSignature Language="C#" Value="public void Activate ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Emits the <see cref="F:Gtk.MenuItem.Activated" /> event on the given item.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Finalize">
<MemberSignature Language="C#" Value="protected override void Finalize ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Disposes the resources associated with the object.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public MenuItem (IntPtr raw);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="raw" Type="System.IntPtr" />
</Parameters>
<Docs>
<summary>Internal constructor</summary>
<param name="raw">Pointer to the C object.</param>
<returns>An instance of MenuItem, wrapping the C object.</returns>
<remarks>
<para>This is an internal constructor, and should not be used by user code.</para>
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public MenuItem ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>A constructor.</summary>
<returns>An instance of <see cref="T:Gtk.MenuItem" />.</returns>
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public MenuItem (string label);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="label" Type="System.String" />
</Parameters>
<Docs>
<summary>Creates a new MenuItem containing a label.</summary>
<param name="label">The label text on the menu item, with an underscore in front of the mnemonic character.</param>
<returns>To be added: an object of type 'Gtk.MenuItem'</returns>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Submenu">
<MemberSignature Language="C#" Value="public Gtk.Widget Submenu { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets or obtains the widget submenu.</summary>
<param name="value">The submenu.</param>
<returns>A submenu for this menu item, or <see langword="null" /> if none.</returns>
<remarks />
</Docs>
</Member>
<Member MemberName="AccelPath">
<MemberSignature Language="C#" Value="public string AccelPath { set; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets the accelerator path.</summary>
<param name="value">An accelerator path, corresponding to this menu item's functionality, or <see langword="null" /> to unset the current path.</param>
<returns>The accelerator path of the menu item.</returns>
<remarks>
<para>
Sets the accelerator path, through which runtime changes of the menu item's accelerator caused by the user can be identified and saved to persistant storage.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="RightJustified">
<MemberSignature Language="C#" Value="public bool RightJustified { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets or obtains whether the menu item appears justified at the right side of a menu bar.</summary>
<param name="value">If <see langword="true" /> the menu item will appear at the far right if added to a menu bar.</param>
<returns>Returns <see langword="true" /> if the menu item will appear at the far right if added to a menu bar.</returns>
<remarks />
</Docs>
</Member>
<Member MemberName="Activated">
<MemberSignature Language="C#" Value="public event EventHandler Activated;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>System.EventHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Emitted when the item is activated.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="ActivateItem">
<MemberSignature Language="C#" Value="public event EventHandler ActivateItem;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>System.EventHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Emitted when the item is activated, but also if the menu item has a submenu. For normal applications, the relevant event is <see cref="F:Gtk.MenuItem.Activated" />.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="ToggleSizeAllocated">
<MemberSignature Language="C#" Value="public event Gtk.ToggleSizeAllocatedHandler ToggleSizeAllocated;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>Gtk.ToggleSizeAllocatedHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Emitted when size is allocated.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="ToggleSizeRequested">
<MemberSignature Language="C#" Value="public event Gtk.ToggleSizeRequestedHandler ToggleSizeRequested;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>Gtk.ToggleSizeRequestedHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Emitted when size is requested.</summary>
<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>To be added</summary>
<returns>a <see cref="T:GLib.GType" /></returns>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="OnToggleSizeRequested">
<MemberSignature Language="C#" Value="protected virtual void OnToggleSizeRequested (out int requisition);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="requisition" Type="System.Int32&amp;" RefType="out" />
</Parameters>
<Docs>
<summary>To be added</summary>
<param name="requisition">a <see cref="T:System.Int32&amp;" /></param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="OnToggleSizeAllocated">
<MemberSignature Language="C#" Value="protected virtual void OnToggleSizeAllocated (int allocation);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="allocation" Type="System.Int32" />
</Parameters>
<Docs>
<summary>To be added</summary>
<param name="allocation">a <see cref="T:System.Int32" /></param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="OnActivateItem">
<MemberSignature Language="C#" Value="protected virtual void OnActivateItem ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>To be added</summary>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="OnActivated">
<MemberSignature Language="C#" Value="protected virtual void OnActivated ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>To be added</summary>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected MenuItem (GLib.GType gtype);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="gtype" Type="GLib.GType" />
</Parameters>
<Docs>
<summary>To be added</summary>
<param name="gtype">a <see cref="T:GLib.GType" /></param>
<returns>a <see cref="T:Gtk.MenuItem" /></returns>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="ToggleSizeRequest">
<MemberSignature Language="C#" Value="public int ToggleSizeRequest ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
2004-03-05 Hector Gomez M <hectorgm@ciencias.unam.mx> * en/* : Created TODO files for every namespace (except *Sharp namespaces). 2004-02-29 Hector Gomez M <hectorgm@ciencias.unam.mx> * Changelog: Corrected bogus year dates. * en/Gtk/TODO: updated TODO list. * en/Atk/EditableText.xml * en/Atk/Free.xml * en/Atk/NoOpObject.xml * en/Atk/Object.xml * en/Atk/StateSet.xml * en/Gnome/CanvasProxy.xml * en/Gnome/CanvasRichText.xml * en/Gnome/Config.xml * en/Gnome/DateEdit.xml * en/Gnome/Entry.xml * en/Gnome/FileEntry.xml * en/Gnome/Font.xml * en/Gnome/FontFamily.xml * en/Gnome/GlyphList.xml * en/Gnome/IconList.xml * en/Gnome/IconTheme.xml * en/Gnome/Pgl.xml * en/Gtk/Combo.xml * en/Gtk/ListStore.xml * en/Gtk/RadioMenuItem.xml * en/Gtk/StockItem.xml * en/Gtk/StockManager.xml * en/Gtk/TextBuffer.xml * en/Gtk/TextIter.xml * en/Gtk/TextView.xml * en/Gtk/TooltipsData.xml * en/Gtk/TreeModelSort.xml * en/Gtk/TreeStore.xml * en/Gtk/TreeView.xml * en/Gtk/Widget.xml * en/Gtk/Window.xml: Restored and/or removed various nodes. * en/Gtk/Accel.xml: Removed deprecated GroupsFromObject Method. * en/Gtk/Application: Removed deprecated CurrentEvent Property. * en/Gtk/Container.xml: FocusChain and Children update. * en/Gtk/DeleteEventArgs.xml: Removed deprecated Event Property. * en/Gtk/DestroyEventArgs.xml: Removed deprecated Event Property. * en/Gtk/MenuItem.xml: ToggleSizeRequest update. * en/Gtk/IMContext.xml: Removed deprecated GetPreeditString Method. * en/Gtk/IMContextSimple.xml: Removed deprecated AddTable Method. * en/Gtk/Init.xml: Removed deprecated AbiCheck Method * en/Gtk/MapEventArgs.xml: Removed deprecated Event Property. * en/Gtk/MenuItem.xml: Removed deprecated ToggleSizeRequest Method. * en/Gtk/NoExposeEventArgs.xml: Removed deprecated Event Property. * en/Gtk/SelectionData.xml: Removed deprecated Set Method. * en/Gtk/TextChildAnchor.xml: Widget update. * en/Gtk/TreeIter.xml: Stamp update. * en/Gtk/TreeModel.xml: EmitRowsReordered update. * en/Gtk/TreeRowReference.xml: Removed deprecated Reordered Method. * en/Gtk/TreeSelection.xml: Removed deprecated GetSelectedRows Method. * en/Gtk/TreeViewColumn.xml: Removed deprecated CellRenders Property. * en/Gtk/UnmapEventArgs.xml: Removed deprecated Event Property. svn path=/trunk/gtk-sharp/; revision=23736
2004-03-05 13:40:13 +00:00
<summary>Emits the <see cref="E:Gtk.MenuItem.ToggleSizeRequested" /> event on the given item.</summary>
<returns>The requisition to use as signal data.</returns>
<remarks />
</Docs>
</Member>
</Members>
</Type>