no more submodule
This commit is contained in:
428
GtkSharp/Source/OldStuff/doc/en/Gtk/IconSource.xml
Normal file
428
GtkSharp/Source/OldStuff/doc/en/Gtk/IconSource.xml
Normal file
@@ -0,0 +1,428 @@
|
||||
<Type Name="IconSource" FullName="Gtk.IconSource">
|
||||
<TypeSignature Language="C#" Maintainer="duncan" Value="public class IconSource : GLib.Opaque" />
|
||||
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit IconSource extends GLib.Opaque" />
|
||||
<AssemblyInfo>
|
||||
<AssemblyName>gtk-sharp</AssemblyName>
|
||||
<AssemblyPublicKey>
|
||||
</AssemblyPublicKey>
|
||||
</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>
|
||||
<Base>
|
||||
<BaseTypeName>GLib.Opaque</BaseTypeName>
|
||||
</Base>
|
||||
<Interfaces>
|
||||
</Interfaces>
|
||||
<Docs>
|
||||
<summary>
|
||||
A GtkIconSource contains a <see cref="T:Gdk.Pixbuf" /> (or image
|
||||
filename) that serves as the base image for one or more of the
|
||||
icons in a <see cref="T:Gtk.IconSet" />, along with a
|
||||
specification for which icons in the icon set will be based on
|
||||
that pixbuf or image file. An icon set contains a set of icons
|
||||
that represent the same logical concept in different states,
|
||||
different global text directions, and different sizes.
|
||||
</summary>
|
||||
<remarks>
|
||||
<para>
|
||||
A <see cref="T:Gtk.IconSource" /> contains a <see cref="T:Gdk.Pixbuf" /> (or image
|
||||
filename) that serves as the base image for one or more of the
|
||||
icons in a <see cref="T:Gtk.IconSet" />, along with a
|
||||
specification for which icons in the icon set will be based on
|
||||
that pixbuf or image file. An icon set contains a set of icons
|
||||
that represent the same logical concept in different states,
|
||||
different global text directions, and different sizes.
|
||||
</para>
|
||||
<para>
|
||||
So for example a web browser's "Back to Previous Page" icon
|
||||
might point in a different direction in Hebrew and in English;
|
||||
it might look different when insensitive; and it might change
|
||||
size depending on toolbar mode (small/large icons). So a
|
||||
single icon set would contain all those variants of the
|
||||
icon. <see cref="T:Gtk.IconSet" /> contains a list of <see cref="T:Gtk.IconSource" /> from which
|
||||
it can derive specific icon variants in the set.
|
||||
</para>
|
||||
<para>
|
||||
In the simplest case, <see cref="T:Gtk.IconSet" /> contains
|
||||
one source pixbuf from which it derives all variants. The
|
||||
<see cref="C:Gtk.IconSet(Gdk.Pixbuf)" /> constructor handles
|
||||
this case; if you only have one source pixbuf, just use that
|
||||
function.
|
||||
</para>
|
||||
<para>
|
||||
If you want to use a different base pixbuf for different icon
|
||||
variants, you create multiple icon sources, mark which
|
||||
variants they'll be used to create, and add them to the icon
|
||||
set with <see cref="M:Gtk.IconSet.AddSource(Gtk.IconSource)" />.
|
||||
</para>
|
||||
<para>
|
||||
By default, the icon source has all parameters
|
||||
wildcarded. That is, the icon source will be used as the base
|
||||
icon for any desired text direction, widget state, or icon
|
||||
size.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
<Members>
|
||||
<Member MemberName=".ctor">
|
||||
<MemberSignature Language="C#" Value="public IconSource ();" />
|
||||
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
|
||||
<MemberType>Constructor</MemberType>
|
||||
<ReturnValue />
|
||||
<Parameters />
|
||||
<Docs>
|
||||
<summary>Creates a new <see cref="T:Gtk.IconSource" />.</summary>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName=".ctor">
|
||||
<MemberSignature Language="C#" Value="public IconSource (IntPtr raw);" />
|
||||
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(native int raw) cil managed" />
|
||||
<MemberType>Constructor</MemberType>
|
||||
<ReturnValue />
|
||||
<Parameters>
|
||||
<Parameter Name="raw" Type="System.IntPtr" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<param name="raw">Pointer to the C object.</param>
|
||||
<summary>Internal constructor</summary>
|
||||
<remarks>
|
||||
<para>This is an internal constructor, and should not be used by user code.</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Copy">
|
||||
<MemberSignature Language="C#" Value="public Gtk.IconSource Copy ();" />
|
||||
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class Gtk.IconSource Copy() cil managed" />
|
||||
<MemberType>Method</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>Gtk.IconSource</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters />
|
||||
<Docs>
|
||||
<summary>
|
||||
Creates a copy of the current <see cref="T:Gtk.IconSource" />; mostly useful for language
|
||||
bindings.
|
||||
</summary>
|
||||
<returns>
|
||||
a new GtkIconSource that is a copy of the current one
|
||||
</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Direction">
|
||||
<MemberSignature Language="C#" Value="public Gtk.TextDirection Direction { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance valuetype Gtk.TextDirection Direction" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>Gtk.TextDirection</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
The text direction this icon source applies to.
|
||||
</summary>
|
||||
<value>
|
||||
Obtains the text direction this icon source applies to. The
|
||||
return value is only useful/meaningful if the text direction
|
||||
is not wildcarded.
|
||||
</value>
|
||||
<remarks>
|
||||
Setting the text direction on an icon source makes no
|
||||
difference if the text direction is wildcarded. Therefore,
|
||||
you should usually set the <see cref="P:Gtk.IconSource.DirectionWildcarded" /> property to
|
||||
un-wildcard it in addition to calling this function.
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="DirectionWildcarded">
|
||||
<MemberSignature Language="C#" Value="public bool DirectionWildcarded { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance bool DirectionWildcarded" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.Boolean</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
If the text direction is wildcarded, this source can be used
|
||||
as the base image for an icon in any <see cref="T:Gtk.TextDirection" />.
|
||||
</summary>
|
||||
<value>Whether the text direction is wildcarded or not</value>
|
||||
<remarks>
|
||||
<para>
|
||||
If the text direction is wildcarded, this source can be
|
||||
used as the base image for an icon in any <see cref="T:Gtk.TextDirection" />. If the text direction is
|
||||
not wildcarded, then the text direction the icon source
|
||||
applies to should be set with <see cref="P:Gtk.IconSource.Direction" />, and the icon source
|
||||
will only be used with that text direction.
|
||||
</para>
|
||||
<para>
|
||||
<see cref="T:Gtk.IconSet" /> prefers non-wildcarded
|
||||
sources (exact matches) over wildcarded sources, and will
|
||||
use an exact match when possible.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Filename">
|
||||
<MemberSignature Language="C#" Value="public string Filename { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance string Filename" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.String</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
Retrieves the source filename, or <see langword="null" /> if none is set.
|
||||
</summary>
|
||||
<value>
|
||||
Retrieves the source filename, or <see langword="null" /> if
|
||||
none is set. The filename is not a copy, and should not be
|
||||
modified or expected to persist beyond the lifetime of the
|
||||
icon source.
|
||||
</value>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Finalize">
|
||||
<MemberSignature Language="C#" Value="~IconSource ();" />
|
||||
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void Finalize() cil managed" />
|
||||
<MemberType>Method</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.Void</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters />
|
||||
<Docs>
|
||||
<summary>To be added.</summary>
|
||||
<remarks>To be added.</remarks>
|
||||
<since version="Gtk# 3.0" />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Free">
|
||||
<MemberSignature Language="C#" Value="public void Free ();" />
|
||||
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Free() cil managed" />
|
||||
<MemberType>Method</MemberType>
|
||||
<Attributes>
|
||||
<Attribute>
|
||||
<AttributeName>System.Obsolete("Gtk.IconSource is now freed automatically")</AttributeName>
|
||||
</Attribute>
|
||||
</Attributes>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.Void</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters />
|
||||
<Docs>
|
||||
<summary>Frees a dynamically-allocated icon source, along with its filename, size, and pixbuf fields.</summary>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Free">
|
||||
<MemberSignature Language="C#" Value="protected override void Free (IntPtr raw);" />
|
||||
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void Free(native int raw) cil managed" />
|
||||
<MemberType>Method</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.Void</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
<Parameter Name="raw" Type="System.IntPtr" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<param name="raw">To be added.</param>
|
||||
<summary>To be added.</summary>
|
||||
<remarks>To be added.</remarks>
|
||||
<since version="Gtk# 3.0" />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GType">
|
||||
<MemberSignature Language="C#" Value="public static GLib.GType GType { get; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property valuetype GLib.GType GType" />
|
||||
<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.IconSource" />.</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="IconName">
|
||||
<MemberSignature Language="C#" Value="public string IconName { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance string IconName" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.String</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters />
|
||||
<Docs>
|
||||
<summary>
|
||||
The name of an icon to look up in the current icon theme
|
||||
to use as a base image when creating icon variants for #GtkIconSet
|
||||
</summary>
|
||||
<value>a <see cref="T:System.String" /></value>
|
||||
<remarks>
|
||||
</remarks>
|
||||
<since version="Gtk# 2.4" />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Pixbuf">
|
||||
<MemberSignature Language="C#" Value="public Gdk.Pixbuf Pixbuf { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance class Gdk.Pixbuf Pixbuf" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>Gdk.Pixbuf</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
The base image used when creating icon variants of a <see cref="T:Gtk.IconSet" /></summary>
|
||||
<value>the source pixbuf, or <see langword="null" /> if none is set.</value>
|
||||
<remarks>
|
||||
<para>
|
||||
If an icon source has both a filename and a pixbuf set, the
|
||||
pixbuf will take priority.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Size">
|
||||
<MemberSignature Language="C#" Value="public Gtk.IconSize Size { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance valuetype Gtk.IconSize Size" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>Gtk.IconSize</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
The icon size this icon source is intended to be used with.
|
||||
</summary>
|
||||
<value>
|
||||
Obtains the icon size this source applies to. The return
|
||||
value is only useful/meaningful if the icon size is not
|
||||
wildcarded.
|
||||
</value>
|
||||
<remarks>
|
||||
Setting the icon size on an icon source makes no difference
|
||||
if the size is wildcarded. Therefore, you should usually set
|
||||
the <see cref="P:Gtk.IconSource.SizeWildcarded" /> property
|
||||
to un-wildcard it in addition to calling this function.
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="SizeWildcarded">
|
||||
<MemberSignature Language="C#" Value="public bool SizeWildcarded { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance bool SizeWildcarded" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.Boolean</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
If the icon size is wildcarded, this source can be used as
|
||||
the base image for an icon of any size. If the size is not
|
||||
wildcarded, then the size the source applies to should be
|
||||
set with <see cref="P:Gtk.IconSource.Size" /> and the icon
|
||||
source will only be used with that specific size.
|
||||
</summary>
|
||||
<value>Whether the size is wildcarded or not</value>
|
||||
<remarks>
|
||||
<para>
|
||||
If the icon size is wildcarded, this source can be used as
|
||||
the base image for an icon of any size. If the size is not
|
||||
wildcarded, then the size the source applies to should be
|
||||
set with <see cref="P:Gtk.IconSource.Size" /> and the icon
|
||||
source will only be used with that specific size.
|
||||
</para>
|
||||
<para>
|
||||
<see cref="T:Gtk.IconSet" /> prefers non-wildcarded
|
||||
sources (exact matches) over wildcarded sources, and will
|
||||
use an exact match when possible.
|
||||
</para>
|
||||
<para>
|
||||
<see cref="T:Gtk.IconSet" /> will normally scale
|
||||
wildcarded source images to produce an appropriate icon at
|
||||
a given size, but will not change the size of source
|
||||
images that match exactly.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="State">
|
||||
<MemberSignature Language="C#" Value="public Gtk.StateType State { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance valuetype Gtk.StateType State" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>Gtk.StateType</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
The widget state this icon source applies to.
|
||||
</summary>
|
||||
<value>
|
||||
Obtains the widget state this icon source applies to. The
|
||||
return value is only useful/meaningful if the widget state
|
||||
is not wildcarded.
|
||||
</value>
|
||||
<remarks>
|
||||
Setting the widget state on an icon source makes no
|
||||
difference if the state is wildcarded. Therefore, you should
|
||||
usually set the <see cref="P:Gtk.IconSource.StateWildcarded" /> propertyto un-wildcard it in addition to calling this
|
||||
function.
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="StateWildcarded">
|
||||
<MemberSignature Language="C#" Value="public bool StateWildcarded { get; set; }" />
|
||||
<MemberSignature Language="ILAsm" Value=".property instance bool StateWildcarded" />
|
||||
<MemberType>Property</MemberType>
|
||||
<ReturnValue>
|
||||
<ReturnType>System.Boolean</ReturnType>
|
||||
</ReturnValue>
|
||||
<Parameters>
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>
|
||||
If the widget state is wildcarded, this source can be used
|
||||
as the base image for an icon in any <see cref="T:Gtk.StateType" />.
|
||||
</summary>
|
||||
<value>
|
||||
Whether or not the widget is wildcarded.
|
||||
</value>
|
||||
<remarks>
|
||||
<para>
|
||||
If the widget state is wildcarded, this source can be used
|
||||
as the base image for an icon in any <see cref="T:Gtk.StateType" />. If the
|
||||
widget state is not wildcarded, then the state the source
|
||||
applies to should be set with <see cref="P:Gtk.IconSource.State" />
|
||||
and the icon source will only be used with that specific
|
||||
state.
|
||||
</para>
|
||||
<para>
|
||||
<see cref="T:Gtk.IconSet" /> prefers non-wildcarded
|
||||
sources (exact matches) over wildcarded sources, and will
|
||||
use an exact match when possible.
|
||||
</para>
|
||||
<para>
|
||||
<see cref="T:Gtk.IconSet" /> will normally transform
|
||||
wildcarded source images to produce an appropriate icon
|
||||
for a given state, for example lightening an image on
|
||||
prelight, but will not modify source images that match
|
||||
exactly.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
</Members>
|
||||
</Type>
|
||||
Reference in New Issue
Block a user