GtkSharp/doc/en/Gdk/Cursor.xml

209 lines
8.8 KiB
XML
Raw Normal View History

<Type Name="Cursor" FullName="Gdk.Cursor">
<TypeSignature Language="C#" Maintainer="auto" Value="public class Cursor : GLib.Opaque" />
<AssemblyInfo>
<AssemblyName>gdk-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>Standard and pixmap cursors</summary>
<remarks>The <see cref="T:Gdk.Cursor" /> represents cursors.</remarks>
</Docs>
<Base>
<BaseTypeName>GLib.Opaque</BaseTypeName>
</Base>
<Interfaces />
<Members>
<Member MemberName="Ref">
<MemberSignature Language="C#" Value="public Gdk.Cursor Ref ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Gdk.Cursor</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Adds a reference to the cursor</summary>
<returns>Same cursor that was passed in.</returns>
<remarks />
</Docs>
</Member>
<Member MemberName="Unref">
<MemberSignature Language="C#" Value="public void Unref ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Removes a reference from cursor, deallocating the cursor if no references remain.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Display">
<MemberSignature Language="C#" Value="public Gdk.Display Display { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Display</ReturnType>
</ReturnValue>
<Docs>
<summary>Returns the display on which the <see cref="T:Gdk.Cursor" /> is defined.</summary>
<value>The <see cref="T:Gdk.Display" /> where the cursor is defined.</value>
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Cursor (IntPtr raw);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="raw" Type="System.IntPtr" />
</Parameters>
<Docs>
<summary>Internal constructor.</summary>
<param name="raw">raw managed pointer.</param>
<remarks>This is an internal constructor, do not use it.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Cursor (Gdk.CursorType cursor_type);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="cursor_type" Type="Gdk.CursorType" />
</Parameters>
<Docs>
<summary>Creates a cursor from standard definitions.</summary>
<param name="cursor_type">The cursor type.</param>
<remarks>Creates a new cursor from the set of builtin cursors for the default display. See gdk_cursor_new_for_display().
<para>
To make the cursor invisible, use gdk_cursor_new_from_pixmap() to create a cursor with no pixels in it.
</para></remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Cursor (Gdk.Display display, Gdk.CursorType cursor_type);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="display" Type="Gdk.Display" />
<Parameter Name="cursor_type" Type="Gdk.CursorType" />
</Parameters>
<Docs>
<summary>Creates a new cursor from the set of builtin cursors.</summary>
<param name="display">The <see cref="T:Gdk.Display" /> for which the cursor will be created.</param>
<param name="cursor_type">Cursor to create.</param>
<remarks>None.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Cursor (Gdk.Pixmap source, Gdk.Pixmap mask, Gdk.Color fg, Gdk.Color bg, int x, int y);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="source" Type="Gdk.Pixmap" />
<Parameter Name="mask" Type="Gdk.Pixmap" />
<Parameter Name="fg" Type="Gdk.Color" />
<Parameter Name="bg" Type="Gdk.Color" />
<Parameter Name="x" Type="System.Int32" />
<Parameter Name="y" Type="System.Int32" />
</Parameters>
<Docs>
<summary>Creates a new cursor from a given pixmap and mask.</summary>
<param name="source">The <see cref="T:Gdk.Pixmap" /> the pixmap specifying the cursor. </param>
<param name="mask">The <see cref="T:Gdk.Pixmap" /> specifying the mask, which must be the same size as source.</param>
<param name="fg">the foreground color, used for the bits in the source which are 1. The color does not have to be allocated first.</param>
<param name="bg"> the background color, used for the bits in the source which are 0. The color does not have to be allocated first.</param>
<param name="x"> the horizontal offset of the 'hotspot' of the cursor.</param>
<param name="y"> the vertical offset of the 'hotspot' of the cursor.</param>
<remarks>Creates a new cursor from a given pixmap and mask. Both the pixmap and mask must have a depth of 1 (i.e. each pixel has only 2 values - on or off). The standard cursor size is 16 by 16 pixels.
<example><code lang="C#">
Gdk.Pixmap pixmap = GetPixmap ();
Gdk.Bitmap mask = GetMask ();
Gdk.Cursor cursor = new Gdk.Cursor (pixmap, mask);
</code></example></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:Gdk.Cursor" />.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Cursor (Gdk.Display display, Gdk.Pixbuf pixbuf, int x, int y);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="display" Type="Gdk.Display" />
<Parameter Name="pixbuf" Type="Gdk.Pixbuf" />
<Parameter Name="x" Type="System.Int32" />
<Parameter Name="y" Type="System.Int32" />
</Parameters>
<Docs>
<summary>To be added</summary>
<param name="display">a <see cref="T:Gdk.Display" /></param>
<param name="pixbuf">a <see cref="T:Gdk.Pixbuf" /></param>
<param name="x">a <see cref="T:System.Int32" /></param>
<param name="y">a <see cref="T:System.Int32" /></param>
<remarks>To be added</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="Type">
* parser/gapi2xml.pl (addFuncElems): if a struct or boxed type has a constructor or a ref, unref, or destroy method, then it must be a reference type, so mark it "opaque" but then also mark all of its fields public and writable. * */*-api*.raw: Regen * generator/Parser.cs (ParseNamespace): make the opaque attribute check actually look at the value of the attribute rather than just checking if it's there, so that you can change a struct's opaque attribute from "true" to "false" via metadata and have that work. * generator/BoxedGen.cs (Generate): do not generate the boxed's "Free" method (since it's guaranteed to crash when we pass it a stack pointer). If "Copy" is marked deprecated, create a deprecated no-op for it, otherwise just skip it (since otherwise it will just leak memory when we copy its result onto the stack). * pango/Pango.metadata: deprecate Pango.Color.Copy and Pango.Matrix.Copy. Hide some array fields in Pango.GlyphString that we've never generated correctly. Tweak Pango.LayoutLine fields to be the same as they used to be. * pango/GlyphItem.custom (glyphs, item): * pango/GlyphString.custom (Zero, New): * pango/Item.custom (Zero, New): * pango/LayoutRun.custom (glyphs, item): add deprecated API compat * gdk/Gdk.metadata: undo the parser's new opaquification of Gdk.Font; it's been deprecated since pre-gtk# times, and no one should be using it, so there's no point in fixing it now. Fix up a few other things to match how they used to be. Fix RgbCmap's constructor args. * gdk/RgbCmap.custom (Zero, New): deprecated API compat * gdk/PangoAttrEmbossed.custom: * gdk/PangoAttrStipple.custom (Zero, New, Attr): deprecated API compat (explicit operator ...): allow casting back and forth between Pango.Attribute. (We can't usefully make them real subclasses of Pango.Attribute, because there's no way for Pango.Attribute.GetAttribute() to be able to dtrt with them.) * gtk/Gtk.metadata: deprecate Gtk.Requisition.Copy, Gtk.TextIter.Copy, and Gtk.TreeIter.Copy. Mark the return value of TextView.DefaultAttributes as "owned". Mark TargetList's fields private so it stays how it used to be. * gtk/TextAttributes.custom (Zero, New): deprecated API compat * gnomevfs/Gnomevfs.metadata: remove a bunch of opaque declarations that the parser figures out on its own now. * art/Art.metadata: * glade/Glade.metadata: * rsvg/Rsvg.metadata: un-mark everything the parser marked opaque in these libraries, because all of the structs in question would still be unusably broken, so the API churn would be pointless. svn path=/trunk/gtk-sharp/; revision=48387
2005-08-15 15:15:57 +00:00
<MemberSignature Language="C#" Value="public Gdk.CursorType Type { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.CursorType</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="Image">
<MemberSignature Language="C#" Value="public Gdk.Pixbuf Image { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Pixbuf</ReturnType>
</ReturnValue>
<Docs>
<summary>A Pixbuf containing the Cursor's image.</summary>
<value>a <see cref="T:Gdk.Pixbuf" /> of the cursor image.</value>
<remarks />
<since version="Gtk# 2.8" />
</Docs>
</Member>
<Member MemberName="NewFromName">
<MemberSignature Language="C#" Value="public static Gdk.Cursor NewFromName (Gdk.Display display, string name);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Gdk.Cursor</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="display" Type="Gdk.Display" />
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<param name="display">The display for which to create the cursor.</param>
<param name="name">The name of the cursor in the Cursor theme.</param>
<summary>Creates a cursor by name in a cursor theme.</summary>
<returns>a <see cref="T:Gdk.Cursor" />, or <see langword="null" />.</returns>
<remarks>Returns <see langword="null" /> if the name doesn't have an associated cursor in the current Cursor theme.</remarks>
<since version="Gtk# 2.8" />
</Docs>
</Member>
</Members>
</Type>