2003-07-17 06:35:10 +00:00
<Type Name= "Accel" FullName= "Gtk.Accel" >
2004-03-17 07:15:15 +00:00
<TypeSignature Language= "C#" Value= "public class Accel" Maintainer= "Alex Combas" />
2003-07-17 06:35:10 +00:00
<AssemblyInfo >
<AssemblyName > gtk-sharp</AssemblyName>
2003-12-24 01:35:30 +00:00
<AssemblyPublicKey >
</AssemblyPublicKey>
2003-07-17 06:35:10 +00:00
<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 >
2004-03-17 07:15:15 +00:00
<summary > Accel Class</summary>
<remarks >
<para > Loadable keyboard accelerator specifications and groups.
</para>
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
<Base >
<BaseTypeName > System.Object</BaseTypeName>
</Base>
<Interfaces />
<Attributes />
<Members >
<Member MemberName= "MapForeach" >
<MemberSignature Language= "C#" Value= "public static void MapForeach (IntPtr data, Gtk.AccelMapForeach foreach_func);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "data" Type= "System.IntPtr" />
<Parameter Name= "foreach_func" Type= "Gtk.AccelMapForeach" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Loops over the entries in the accelerator.</summary>
<param name= "data" > The <see cref= "T:System.IntPtr" /> data to be passed into <paramref name= "foreach_func" /> .</param>
<param name= "foreach_func" > A <see cref= "T:Gtk.AccelMapForeach" /> function to be executed for each accel map entry which is not filtered out.</param>
<remarks >
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
Loops over the entries in the accelerator whose accel path doesn't match any of the filters added with <see cref= "M:Gtk.Accel.MapAddFilter()" /> ,
and exectutes <paramref name= "foreach_fun" /> on each.
</para>
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
The signature of <paramref name= "foreach_func" /> is that of <see cref= "T:Gtk.AccelMapForeach" /> ,
the changed parameter indicates wheather this accelerator was changed during
runtime (thus, would need saving during an accelerator map dump).
</para>
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapLoad" >
<MemberSignature Language= "C#" Value= "public static void MapLoad (string file_name);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "file_name" Type= "System.String" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Parses through a file previously saved with <see cref= "Gtk.Accel.MapSave()" /> for accelerator specifications, and propagates them accordingly.</summary>
<param name= "file_name" > A <see cref= "T:System.String" /> file containing accelerator specifications.</param>
<remarks />
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "GroupsActivate" >
<MemberSignature Language= "C#" Value= "public static bool GroupsActivate (GLib.Object objekt, uint accel_key, Gdk.ModifierType accel_mods);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Boolean</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "objekt" Type= "GLib.Object" />
<Parameter Name= "accel_key" Type= "System.UInt32" />
<Parameter Name= "accel_mods" Type= "Gdk.ModifierType" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Finds the first accelerator in any <see cref= "T:Gtk.AccelGroup" /> .</summary>
<param name= "objekt" > An <see cref= "T:GLib.Object" /> usually a <see cref= "T:Gtk.Window" /> , on which to activate the accelerator.</param>
<param name= "accel_key" > An <see cref= "T:System.UInt32" /> accelerator keyval from a key event.</param>
<param name= "accel_mods" > A <see cref= "T:Gdk.ModifierType" /> keyboard state mask from a key event.</param>
<returns > A <see cref= "T:System.Boolean" /> returns <see langword= "true" /> if the accelerator was handled, and <see langword= "false" /> otherwise.</returns>
<remarks >
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
Finds the first accelerator in any <see cref= "T:Gtk.AccelGroup" /> attached
to <paramref name= "objekt" /> that matches <paramref name= "accel_key" /> and
<paramref name= "accel_mods" /> , and activates that accelerator.
</para>
2004-05-27 19:02:19 +00:00
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapChangeEntry" >
<MemberSignature Language= "C#" Value= "public static bool MapChangeEntry (string accel_path, uint accel_key, Gdk.ModifierType accel_mods, bool replace);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Boolean</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "accel_path" Type= "System.String" />
<Parameter Name= "accel_key" Type= "System.UInt32" />
<Parameter Name= "accel_mods" Type= "Gdk.ModifierType" />
<Parameter Name= "replace" Type= "System.Boolean" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Changes the <paramref name= "accel_key" /> and <paramref name= "accel_mods" /> currently associated with <paramref name= "accel_path" /> .</summary>
<param name= "accel_path" > A <see cref= "T:System.String" /> valid accelerator path.</param>
<param name= "accel_key" > An <see cref= "T:System.UInt32" /> new accelerator key.</param>
<param name= "accel_mods" > A <see cref= "T:Gdk.ModifierType" /> new accelerator modifier.</param>
<param name= "replace" > A <see cref= "T:System.Boolean" /> returns <see langword= "true" /> if other accelerators may be deleted upon conflicts.</param>
<returns > A <see cref= "T:System.Boolean" /> that returns <see langword= "true" /> if the accelerator can be changed, and <see langword= "false" /> otherwise.</returns>
<remarks >
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
Due to conflicts with other accelerators, a change may not always be possible, <paramref name= "replace" />
indicates wheather other accelerators may be deleted to resolve such conflicts. A changed will only occur if all conflicts
could be resolved (which might not be the case if conflicting accelerators are locked).
</para>
2004-05-27 19:02:19 +00:00
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapLookupEntry" >
<MemberSignature Language= "C#" Value= "public static bool MapLookupEntry (string accel_path, Gtk.AccelKey key);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Boolean</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "accel_path" Type= "System.String" />
<Parameter Name= "key" Type= "Gtk.AccelKey" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Looks up the accelerator entry for <paramref name= "accel_path" /> and fills in <paramref name= "key" /> .</summary>
<param name= "accel_path" > A <see cref= "T:System.String" /> valid accelerator path.</param>
<param name= "key" > An <see cref= "T:Gtk.AccelKey" /> accelerator key to be filled in (optional).</param>
<returns > A <see cref= "T:System.Boolean" /> returns <see langword= "true" /> if <paramref name= "accel_path" /> is known, and <see langword= "false" /> otherwise.</returns>
<remarks />
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapLoadFd" >
<MemberSignature Language= "C#" Value= "public static void MapLoadFd (int fd);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "fd" Type= "System.Int32" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Filedescriptor variant of <see cref= "M:Gtk.Accel.MapLoad()" /> .</summary>
<param name= "fd" > An <see cref= "T:System.Int32" /> valid readable file descriptor.</param>
<remarks > Note that the file descriptor will not be closed by this function.</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapAddEntry" >
<MemberSignature Language= "C#" Value= "public static void MapAddEntry (string accel_path, uint accel_key, Gdk.ModifierType accel_mods);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "accel_path" Type= "System.String" />
<Parameter Name= "accel_key" Type= "System.UInt32" />
<Parameter Name= "accel_mods" Type= "Gdk.ModifierType" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Registers a new accelerator with the global accelerator map.</summary>
<param name= "accel_path" > A <see cref= "T:System.String" /> valid accelerator path.</param>
<param name= "accel_key" > An <see cref= "T:System.UInt32" /> accelerator key.</param>
<param name= "accel_mods" > A <see cref= "T:Gdk.ModifierType" /> accelerator modifier.</param>
<remarks >
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
This function should only be called once per <paramref name= "accel_path" /> with the canonical
<paramref name= "accel_key" /> and <paramref name= "accel_mods" /> for this path.
To change the accelerator during runtime programatically, use <see cref= "M:Gtk.Accel.MapChangeEntry()" /> .
</para>
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
The accelerator path must consist of "< WINDOWTYPE> /Category1/Category2/.../Action", where
< WINDOWTYPE> should be a unique application-specific indentifier, that corresponds to the
kind of window the accelerator is being used in, e.g. "Gimp-Image", "Abiword-Document" or
"Gnumeric-Settings". The Category1/.../Action portion is most appropriately chosen by the action
the accelerator triggers, i.e. for accelerators on menu items, choose the items's menu path,
e.g. "File/Save As", "Image/View/Zoom" or "Edit/Select All". So a valid accelerator path may
look like this: "< Gimp-Toolbox> /File/Dialogs/ToolOptions..".
</para>
2004-05-27 19:02:19 +00:00
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapSaveFd" >
<MemberSignature Language= "C#" Value= "public static void MapSaveFd (int fd);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "fd" Type= "System.Int32" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Filedescriptor variant of <see cref= "M:Gtk.Accel.MapSave()" /> .</summary>
<param name= "fd" > An <see cref= "T:System.Int32" /> valid writeable file descriptor.</param>
<remarks > Note that the file descriptor will not be closed by this function.</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapForeachUnfiltered" >
<MemberSignature Language= "C#" Value= "public static void MapForeachUnfiltered (IntPtr data, Gtk.AccelMapForeach foreach_func);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "data" Type= "System.IntPtr" />
<Parameter Name= "foreach_func" Type= "Gtk.AccelMapForeach" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Loops over all the entries in the accelerator map, and executes <paramref name= "foreach_func" /> on each.</summary>
<param name= "data" > An <see cref= "T:System.IntPtr" /> data to be passed into the <paramref name= "foreach_func" /> .</param>
<param name= "foreach_func" > An <see cref= "T:Gtk.AccelMapForeach" /> function to be exacuted for each accel map entry.</param>
<remarks >
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
The signature of <paramref name= "foreach_func" /> is that of <see cref= "T:Gtk.AccelMapForeach" /> ,
the changed parameter indicates whether this accelerator was changed during runtime
(thus, would need saving during an accelerator map dump).
</para>
2004-05-27 19:02:19 +00:00
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapAddFilter" >
<MemberSignature Language= "C#" Value= "public static void MapAddFilter (string filter_pattern);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "filter_pattern" Type= "System.String" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Adds a filter to the global list of accel path filters.</summary>
<param name= "filter_pattern" > A <see cref= "T:System.String" /> pattern.</param>
<remarks >
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
Accel map entries whose accel path matches one of the filters are skipped
2004-08-05 22:35:12 +00:00
by <see cref= "M:Gtk.Accel.MapForeach()" /> .
This function is intended for gtk-sharp modules that create their own menus but don't want
2004-03-17 07:15:15 +00:00
them to be saved into the applications accelerator map dump.
</para>
2004-05-27 19:02:19 +00:00
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= "MapSave" >
<MemberSignature Language= "C#" Value= "public static void MapSave (string file_name);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-09-17 21:56:59 +00:00
<Parameter Name= "file_name" Type= "System.String" />
</Parameters>
2003-07-17 06:35:10 +00:00
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Saves current accelerator specifications.</summary>
<param name= "file_name" > A <see cref= "T:System.String" /> file to contain accelerator specifications.</param>
<remarks >
2004-05-27 19:02:19 +00:00
<para >
2004-03-17 07:15:15 +00:00
Saves current accelerator specifications (accelerator path, key, modifiers to
<paramref name= "file_name" /> . The file is written in a format suitable to be read
back in by <see cref= "M:Gtk.Accel.MapLoad()" /> .
</para>
2004-05-27 19:02:19 +00:00
</remarks>
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
<Member MemberName= ".ctor" >
<MemberSignature Language= "C#" Value= "public Accel ();" />
<MemberType > Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs >
2004-03-17 07:15:15 +00:00
<summary />
<returns > An <see cref= "T:Gtk.Accel" /> default constructor.</returns>
<remarks />
2003-07-17 06:35:10 +00:00
</Docs>
</Member>
2004-02-26 18:46:28 +00:00
<Member MemberName= "GroupsFromObject" >
<MemberSignature Language= "C#" Value= "public static Gtk.AccelGroup[] GroupsFromObject (GLib.Object obj);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > Gtk.AccelGroup[]</ReturnType>
</ReturnValue>
<Parameters >
<Parameter Name= "obj" Type= "GLib.Object" />
</Parameters>
<Docs >
2004-03-17 07:15:15 +00:00
<summary > Gets a list of all accel groups which are attached to <paramref name= "obj" /> .</summary>
<param name= "obj" > An <see cref= "T:GLib.Object" /> usually a <see cref= "T:Gtk.Window" /> .</param>
<returns > An <see cref= "T:Gtk.AccelGroup[]" /> list of all accel groups which are attached to <paramref name= "obj" /> .</returns>
<remarks />
2004-02-26 18:46:28 +00:00
</Docs>
</Member>
2003-07-17 06:35:10 +00:00
</Members>
2004-08-05 22:35:12 +00:00
</Type>
