Cursor

Cursor

serializable, disposable

---

System. Windows .Forms (system. windows .forms.dll)

sealed class

This class wraps a Win32 cursorthe image that represents the mouse pointer. Cursor is a slightly curious class in that it wraps up both GDI-like functionality and global system cursor/pointer behavior.

Unlike Win32, .NET cursors are static imagesyou cannot create them from animations. You can, however, create cursors from COM IPicture objects, files and streams, and Win32 cursor handles. You can also retrieve a Win32 handle using the Handle property, or get a copy of the underlying Win32 object with the CopyHandle() method. Predefined cursors are available as static properties on the Cursors class.

Similar to most of the System.Drawing objects, Cursor objects are a scarce system resource, and therefore you should manage their lifetimes carefully , calling Dispose() when you are finished to release the resources back to the OS. Also in keeping with the drawing objects, you can paint the cursor imagery on a System.Drawing.Graphics surface using the Draw( ) and DrawStretched() methods . The object's dimensions can be obtained from the Size property.

Each Control object has a Cursor property, which you can use to the set the default cursor shown while the mouse is over the control. You can also temporarily set the cursor to something else (such as the Cursors.WaitCursor ) by using the static Current property. This overrides any other settings until you either set the Current value back to Cursors.Default or call the DoEvents() method.

You can find the screen coordinates at which the cursor is currently being rendered by using the static Position property, and the expected dimensions of the system cursor from the static Clip .

You can also Show() and Hide() the cursor through static methods of those names . If the cursor is hidden, Current will return null.

 public sealed class  Cursor  : IDisposable, System.Runtime.Serialization.ISerializable {  // Public Constructors  public  Cursor  (IntPtr  handle  );    public  Cursor  (System.IO.Stream  stream  );    public  Cursor  (string  fileName  );    public  Cursor  (Type  type  , string  resource  );  // Public Static Properties  public static Rectangle  Clip  {set; get; }    public static Cursor  Current  {set; get; }    public static Point  Position  {set; get; }  // Public Instance Properties  public IntPtr  Handle  {get; }    public Size  Size  {get; }  // Public Static Methods  public static void  Hide  ();    public static void  Show  ();    public static bool operator  !=  (Cursor  left  , Cursor  right  );    public static bool operator  ==  (Cursor  left  , Cursor  right  );  // Public Instance Methods  public IntPtr  CopyHandle  ();    public void  Dispose  ();  // implements IDisposable  public void  Draw  (System.Drawing.Graphics  g  , System.Drawing.Rectangle  targetRect  );    public void  DrawStretched  (System.Drawing.Graphics  g  , System.Drawing.Rectangle  targetRect  );    public override bool  Equals  (object  obj  );  // overrides object  public override int  GetHashCode  ();  // overrides object  public override string  ToString  ();  // overrides object   // Protected Instance Methods  protected override void  Finalize  ();  // overrides object  } 

Returned By

Multiple types

Passed To

AmbientProperties.Cursor , AxHost.GetIPictureFromCursor() , Control.Cursor , LinkLabel.OverrideCursor