GtkSharp/doc/en/Atk/Image.xml

<Type Name="Image" FullName="Atk.Image">
  <TypeSignature Language="C#" Maintainer="auto" Value="public interface Image : GLib.IWrapper" />
  <TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract Image implements class GLib.IWrapper" />
  <AssemblyInfo>
    <AssemblyName>atk-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>
  <Interfaces>
    <Interface>
      <InterfaceName>GLib.IWrapper</InterfaceName>
    </Interface>
  </Interfaces>
  <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>
  <Members>
    <Member MemberName="GetImagePosition">
      <MemberSignature Language="C#" Value="public void GetImagePosition (out int x, out int y, Atk.CoordType coord_type);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void GetImagePosition(int32 x, int32 y, valuetype Atk.CoordType coord_type) cil managed" />
      <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>
        <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>
        <summary>Gets the position of the image in the form of a point specifying the images top-left corner.</summary>
        <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);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void GetImageSize(int32 width, int32 height) cil managed" />
      <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>
        <param name="width">the image width</param>
        <param name="height">the image height</param>
        <summary>Get the width and height in pixels for the specified image.</summary>
        <remarks>
          The values of <paramref name="width" /> and <paramref name="height" /> are returned as -1 if the values cannot be
          obtained.
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="ImageDescription">
      <MemberSignature Language="C#" Value="public string ImageDescription { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance string ImageDescription" />
      <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="ImageLocale">
      <MemberSignature Language="C#" Value="public string ImageLocale { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance string ImageLocale" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <summary>To be added.</summary>
        <value>To be added.</value>
        <remarks>To be added.</remarks>
        <since version="Gtk# 2.12" />
      </Docs>
    </Member>
    <Member MemberName="SetImageDescription">
      <MemberSignature Language="C#" Value="public bool SetImageDescription (string description);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance bool SetImageDescription(string description) cil managed" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="description" Type="System.String" />
      </Parameters>
      <Docs>
        <param name="description">a description to set for image</param>
        <summary>Sets the textual description for this image.</summary>
        <returns>
          <see langword="true" />, or <see langword="false" /> if operation could not be completed.</returns>
        <remarks />
      </Docs>
    </Member>
  </Members>
</Type>