Ryujinx-GtkSharp/doc/en/Gtk/IconFactory.xml
Mike Kestner 3402acb805 assembly version updates for 2.12
svn path=/trunk/gtk-sharp/; revision=90841
2007-12-06 18:37:54 +00:00

236 lines
10 KiB
XML

<Type Name="IconFactory" FullName="Gtk.IconFactory">
<TypeSignature Language="C#" Maintainer="duncan" Value="public class IconFactory : GLib.Object" />
<AssemblyInfo>
<AssemblyName>gtk-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</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>An icon factory manages a collection of <see cref="T:Gtk.IconSet" /></summary>
<remarks />
</Docs>
<Base>
<BaseTypeName>GLib.Object</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<Members>
<Member MemberName="LookupDefault">
<MemberSignature Language="C#" Value="public static Gtk.IconSet LookupDefault (string stock_id);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Gtk.IconSet</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="stock_id" Type="System.String" />
</Parameters>
<Docs>
<summary>Looks for an icon in the list of default icon factories.</summary>
<param name="stock_id">an icon name</param>
<returns>
a <see cref="T:Gtk.IconSet" />, or <see langword="null" />.
</returns>
<remarks>
Looks for an icon in the list of default icon factories. For
display to the user, you should use
<see cref="M:Gtk.Style.LookupIconSet(System.String)" /> on the <see cref="T:Gtk.Style" /> for the widget
that will display the icon, instead of using this function
directly, so that themes are taken into account.
</remarks>
</Docs>
</Member>
<Member MemberName="AddDefault">
<MemberSignature Language="C#" Value="public void AddDefault ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>
Adds an icon factory to the list of icon factories searched
by <see cref="M:Gtk.Style.LookupIconSet" />.
</summary>
<remarks>
Adds an icon factory to the list of icon factories searched
by <see cref="M:Gtk.Style.LookupIconSet(System.String)" />. This means that, for example, <see cref="C:Gtk.Image(System.String,Gtk.IconSize)" /> will be
able to find icons in factory. There will normally be an
icon factory added for each library or application that
comes with icons. The default icon factories can be
overridden by themes.
</remarks>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (string stock_id, Gtk.IconSet icon_set);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="stock_id" Type="System.String" />
<Parameter Name="icon_set" Type="Gtk.IconSet" />
</Parameters>
<Docs>
<summary>
Adds the given <paramref name="icon_set" /> to the icon factory, under the name
<paramref name="stock_id" />.
</summary>
<param name="stock_id">The icon's name</param>
<param name="icon_set"> The icon set</param>
<remarks>
Adds the given <paramref name="icon_set" /> to the icon factory, under the name
<paramref name="stock_id" />. <paramref name="stock_id" /> should be namespaced for your
application, e.g. "myapp-name-of-icon". Normally
applications create a <see cref="T:Gtk.IconFactory" />, then add it to the
list of default factories with
<see cref="M:Gtk.IconFactory.AddDefault" />. They pass the
<paramref name="stock_id" /> to widgets such as <see cref="T:Gtk.Image" /> to display the icon. Themes can
provide an icon with the same name (such as
"myapp-name-of-icon") to override your application's
default icons. If an icon already existed in factory for
<paramref name="stock_id" />, it is unreferenced and replaced with the new
<paramref name="icon_set" />.
</remarks>
</Docs>
</Member>
<Member MemberName="Lookup">
<MemberSignature Language="C#" Value="public Gtk.IconSet Lookup (string stock_id);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Gtk.IconSet</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="stock_id" Type="System.String" />
</Parameters>
<Docs>
<summary>
Looks up a Stock ID in the icon factory.
</summary>
<param name="stock_id">an icon name</param>
<returns>
a <see cref="T:Gtk.IconSet" />, or <see langword="null" />.
</returns>
<remarks>
Looks up <paramref name="stock_id" /> in the icon factory, returning an icon set
if found, otherwise <see langword="null" />. For display to the user, you
should use <see cref="M:Gtk.Style.LookupIconSet(System.String)" /> on the
<see cref="T:Gtk.Style" /> for
the widget that will display the icon, instead of using this
function directly, so that themes are taken into account.
</remarks>
</Docs>
</Member>
<Member MemberName="RemoveDefault">
<MemberSignature Language="C#" Value="public void RemoveDefault ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>
Removes an icon factory from the list of default icon factories.
</summary>
<remarks>
Removes an icon factory from the list of default icon
factories. Not normally used; you might use it for a library
that can be unloaded or shut down.
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public IconFactory (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>
<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 IconFactory ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Creates a new <see cref="T:Gtk.IconFactory" />.</summary>
<remarks>
Creates a new <see cref="T:Gtk.IconFactory" />. An icon factory manages a
collection of <see cref="T:Gtk.IconSet" />s; a <see cref="T:Gtk.IconSet" /> manages a set of
variants of a particular icon (i.e. a GtkIconSet contains
variants for different sizes and widget states). Icons in an
icon factory are named by a stock ID, which is a simple
string identifying the icon. Each <see cref="T:Gtk.Style" /> has a list of
GtkIconFactorys derived from the current theme; those icon
factories are consulted first when searching for an icon. If
the theme doesn't set a particular icon, GTK+ looks for the
icon in a list of default icon factories, maintained by
<see cref="M:Gtk.IconFactory.AddDefault" /> and
<see cref="M:Gtk.IconFactory.RemoveDefault" />. Applications with icons
should add a default icon factory with their icons, which
will allow themes to override the icons for the application.
</remarks>
</Docs>
</Member>
<Member MemberName="LookupIconSize">
<MemberSignature Language="C#" Value="public void LookupIconSize (Gtk.IconSize size, out int width, out int height);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="size" Type="Gtk.IconSize" />
<Parameter Name="width" Type="System.Int32&amp;" RefType="out" />
<Parameter Name="height" Type="System.Int32&amp;" RefType="out" />
</Parameters>
<Docs>
<summary>Obtains the pixel size of a semantic icon size</summary>
<param name="size">an icon size</param>
<param name="width">an integer to store the icon's width</param>
<param name="height">an integer to store the icon's height</param>
<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>GType Property.</summary>
<value>a <see cref="T:GLib.GType" /></value>
<remarks>Returns the native <see cref="T:GLib.GType" /> value for <see cref="T:Gtk.IconFactory" />.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected IconFactory (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>
<remarks>Chain to this constructor if you have manually registered a native <see cref="T:GLib.GType" /> value for your subclass.</remarks>
</Docs>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete</AttributeName>
</Attribute>
</Attributes>
</Member>
</Members>
</Type>