GtkSharp/doc/en/Atk/Image.xml
Mike Kestner ab07fa8056 updates to assembly version elements
svn path=/trunk/gtk-sharp/; revision=46164
2005-06-17 18:43:30 +00:00

119 lines
4.9 KiB
XML

<Type Name="Image" FullName="Atk.Image">
<TypeSignature Language="C#" Maintainer="auto" Value="public interface Image : GLib.IWrapper" />
<AssemblyInfo>
<AssemblyName>atk-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>2.6.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>
Implemented by AtkObject subtypes on behalf of components which
display image/pixmap information onscreen, and which provide
information (other than just widget borders, etc.) via that
image content.
</summary>
<remarks>
<para>
<see cref="T:Atk.Image" /> should be implemented by <see cref="T:Atk.Object" /> subtypes on behalf
of components which display image/pixmap information onscreen,
and which provide information (other than just widget borders,
etc.) via that image content. For instance, icons, buttons
with icons, toolbar elements, and image viewing panes
typically should implement AtkImage.
</para>
<para>
<see cref="T:Atk.Image" /> primarily provides two types of information:
coordinate information (useful for screen review mode of
screenreaders, and for use by onscreen magnifiers), and
descriptive information. The descriptive information is
provided for alternative, text-only presentation of the most
significant information present in the image.
</para>
</remarks>
</Docs>
<Interfaces>
<Interface>
<InterfaceName>GLib.IWrapper</InterfaceName>
</Interface>
</Interfaces>
<Members>
<Member MemberName="SetImageDescription">
<MemberSignature Language="C#" Value="public bool SetImageDescription (string description);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="description" Type="System.String" />
</Parameters>
<Docs>
<summary>Sets the textual description for this image.</summary>
<param name="description">a description to set for image</param>
<returns>
<see langword="true" />, or <see langword="false" /> if operation could not be completed.</returns>
<remarks />
</Docs>
</Member>
<Member MemberName="ImageDescription">
<MemberSignature Language="C#" Value="public string ImageDescription { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>Get a textual description of this image.</summary>
<value>a string representing the image description</value>
<remarks />
</Docs>
</Member>
<Member MemberName="GetImagePosition">
<MemberSignature Language="C#" Value="public void GetImagePosition (out int x, out int y, Atk.CoordType coord_type);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="x" Type="System.Int32&amp;" RefType="out" />
<Parameter Name="y" Type="System.Int32&amp;" RefType="out" />
<Parameter Name="coord_type" Type="Atk.CoordType" />
</Parameters>
<Docs>
<summary>Gets the position of the image in the form of a point specifying the images top-left corner.</summary>
<param name="x">x coordinate position</param>
<param name="y">y coordinate position</param>
<param name="coord_type">
specifies whether the coordinates are relative to the
screen or to the components top level window
</param>
<remarks>
<para>
The values of <paramref name="x" /> and <paramref name="y" />are returned as -1 if the values cannot be obtained.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="GetImageSize">
<MemberSignature Language="C#" Value="public void GetImageSize (out int width, out int height);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="width" Type="System.Int32&amp;" RefType="out" />
<Parameter Name="height" Type="System.Int32&amp;" RefType="out" />
</Parameters>
<Docs>
<summary>Get the width and height in pixels for the specified image.</summary>
<param name="width">the image width</param>
<param name="height">the image height</param>
<remarks>
The values of <paramref name="width" /> and <paramref name="height" /> are returned as -1 if the values cannot be
obtained.
</remarks>
</Docs>
</Member>
</Members>
</Type>