Cursors Class

Provides a collection of Cursor objects for use by a Windows Forms application.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

'Declaration
Public NotInheritable Class Cursors
'Usage
Dim instance As Cursors

public final class Cursors
public final class Cursors

Some of the Cursor objects in this class can take on a different appearance than those described. The user can change the cursor appearance by adjusting the mouse pointer settings in their operating system. The panning and no move cursors are static and cannot be changed by the operating system.

The panning and no move cursors are used during mouse wheel operations. Depending on the direction the window can be scrolled, the cursor changes to the appropriate no move cursor when the mouse wheel is clicked. The cursor then changes to the appropriate panning cursor as the mouse is moved.

The following example demonstrates changing the mouse cursor using the Control.Cursor property, the Cursor class, and the Cursors class. The example creates a form that contains a ComboBox control, a Panel control, and a ListView control. The ComboBox contains all cursors provided by the Cursors class. When the user selects a mouse cursor in the ComboBox, the Control.Cursor property is set to the selected cursor, which updates the cursor for the Panel. The ListView is updated every time the Control.CursorChanged event occurs.

Imports System
Imports System.Drawing
Imports System.Windows.Forms

Namespace MCursor
    
    ' Summary description for Form1.
    Public NotInheritable Class Form1
        Inherits System.Windows.Forms.Form

        Friend WithEvents cursorSelectionComboBox As System.Windows.Forms.ComboBox
        Friend WithEvents testPanel As System.Windows.Forms.Panel

        Private label1 As System.Windows.Forms.Label
        Private label2 As System.Windows.Forms.Label
        Private cursorEventViewer As System.Windows.Forms.ListView
        Private label3 As System.Windows.Forms.Label

        <System.STAThread()> _
        Public Shared Sub Main()
            System.Windows.Forms.Application.Run(New Form1)
        End Sub 'Main

        Public Sub New()

            Me.cursorSelectionComboBox = New System.Windows.Forms.ComboBox
            Me.testPanel = New System.Windows.Forms.Panel
            Me.label1 = New System.Windows.Forms.Label
            Me.label2 = New System.Windows.Forms.Label
            Me.cursorEventViewer = New System.Windows.Forms.ListView
            Me.label3 = New System.Windows.Forms.Label

            ' Select Cursor Label
            Me.label2.Location = New System.Drawing.Point(24, 16)
            Me.label2.Size = New System.Drawing.Size(80, 16)
            Me.label2.Text = "Select cursor:"            '

            ' Cursor Testing Panel Label
            Me.label1.Location = New System.Drawing.Point(24, 80)
            Me.label1.Size = New System.Drawing.Size(144, 23)
            Me.label1.Text = "Cursor testing panel:"

            ' Cursor Changed Events Label
            Me.label3.Location = New System.Drawing.Point(184, 16)
            Me.label3.Size = New System.Drawing.Size(128, 16)
            Me.label3.Text = "Cursor changed events:"

            ' Cursor Selection ComboBox
            Me.cursorSelectionComboBox.Location = New System.Drawing.Point(24, 40)
            Me.cursorSelectionComboBox.Size = New System.Drawing.Size(152, 21)
            Me.cursorSelectionComboBox.TabIndex = 0

            ' Cursor Test Panel
            Me.testPanel.BackColor = System.Drawing.SystemColors.ControlDark
            Me.testPanel.Location = New System.Drawing.Point(24, 104)
            Me.testPanel.Size = New System.Drawing.Size(152, 160)

            ' Cursor Event ListView
            Me.cursorEventViewer.Location = New System.Drawing.Point(184, 40)
            Me.cursorEventViewer.Size = New System.Drawing.Size(256, 224)
            Me.cursorEventViewer.TabIndex = 4
            Me.cursorEventViewer.View = System.Windows.Forms.View.List

            ' Set up how the form should be displayed and add the controls to the form.
            Me.ClientSize = New System.Drawing.Size(456, 286)
            Me.Controls.AddRange(New System.Windows.Forms.Control() {Me.label3, _
                                    Me.cursorEventViewer, Me.label2, Me.label1, _
                                    Me.testPanel, Me.cursorSelectionComboBox})

            Me.Text = "Cursors Example"

            ' Add all the cursor types to the combobox.
            Dim cursor As Cursor
            For Each cursor In CursorList()
                cursorSelectionComboBox.Items.Add(cursor)
            Next cursor
        End Sub 'New 

        Private Function CursorList() As Cursor()
            ' Make an array of all the types of cursors in Windows Forms.
            return New Cursor() {Cursors.AppStarting, Cursors.Arrow, Cursors.Cross, _
                                 Cursors.Default, Cursors.Hand, Cursors.Help, _
                                 Cursors.HSplit, Cursors.IBeam, Cursors.No, _
                                 Cursors.NoMove2D, Cursors.NoMoveHoriz, Cursors.NoMoveVert, _
                                 Cursors.PanEast, Cursors.PanNE, Cursors.PanNorth, _
                                 Cursors.PanNW, Cursors.PanSE, Cursors.PanSouth, _
                                 Cursors.PanSW, Cursors.PanWest, Cursors.SizeAll, _
                                 Cursors.SizeNESW, Cursors.SizeNS, Cursors.SizeNWSE, _
                                 Cursors.SizeWE, Cursors.UpArrow, Cursors.VSplit, Cursors.WaitCursor}
        End Function

        Private Sub cursorSelectionComboBox_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles cursorSelectionComboBox.SelectedIndexChanged
            ' Set the cursor in the test panel to be the selected cursor style.
            testPanel.Cursor = CType(cursorSelectionComboBox.SelectedItem, Cursor)

        End Sub 

        Private Sub testPanel_CursorChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles testPanel.CursorChanged
            ' Build up a string containing the type of object sending the event, and the event.
            Dim cursorEvent As String = String.Format("[{0}]: {1}", sender.GetType().ToString(), "Cursor changed")

            ' Records this event in the list view.
            Me.cursorEventViewer.Items.Add(cursorEvent)

        End Sub 

    End Class 'Form1
End Namespace 'MCursor

package MCursor;

import System.*;
import System.Drawing.*;
import System.Windows.Forms.*;
import System.Collections.*;

public class Form1 extends System.Windows.Forms.Form
{
    private System.Windows.Forms.ComboBox cursorSelectionComboBox;
    private System.Windows.Forms.Panel testPanel;
    private System.Windows.Forms.Label label1;
    private System.Windows.Forms.Label label2;
    private System.Windows.Forms.ListView cursorEventViewer;
    private System.Windows.Forms.Label label3;

    /** @attribute STAThread()
     */
    public static void main(String[] args)
    {
        Application.Run(new Form1());
    } //main

    public Form1()
    {
        this.cursorSelectionComboBox = new System.Windows.Forms.ComboBox();
        this.testPanel = new System.Windows.Forms.Panel();
        this.label1 = new System.Windows.Forms.Label();
        this.label2 = new System.Windows.Forms.Label();
        this.cursorEventViewer = new System.Windows.Forms.ListView();
        this.label3 = new System.Windows.Forms.Label();
        // Select Cursor Label
        this.label2.set_Location(new System.Drawing.Point(24, 16));
        this.label2.set_Size(new System.Drawing.Size(80, 16));
        this.label2.set_Text("Select cursor:");
        // Cursor Testing Panel Label
        this.label1.set_Location(new System.Drawing.Point(24, 80));
        this.label1.set_Size(new System.Drawing.Size(144, 23));
        this.label1.set_Text("Cursor testing panel:");
        // Cursor Changed Events Label
        this.label3.set_Location(new System.Drawing.Point(184, 16));
        this.label3.set_Size(new System.Drawing.Size(128, 16));
        this.label3.set_Text("Cursor changed events:");
        // Cursor Selection ComboBox
        this.cursorSelectionComboBox.set_Location(
            new System.Drawing.Point(24, 40));
        this.cursorSelectionComboBox.set_Size(
            new System.Drawing.Size(152, 21));
        this.cursorSelectionComboBox.set_TabIndex(0);
        this.cursorSelectionComboBox.add_SelectedIndexChanged(
            new System.EventHandler(
            this.cursorSelectionComboBox_SelectedIndexChanged));
        // Cursor Test Panel
        this.testPanel.set_BackColor(
            System.Drawing.SystemColors.get_ControlDark());
        this.testPanel.set_Location(new System.Drawing.Point(24, 104));
        this.testPanel.set_Size(new System.Drawing.Size(152, 160));
        this.testPanel.add_CursorChanged(new System.EventHandler(
            this.testPanel_CursorChanged));
        // Cursor Event ListView
        this.cursorEventViewer.set_Location(new System.Drawing.Point(184, 40));
        this.cursorEventViewer.set_Size(new System.Drawing.Size(256, 224));
        this.cursorEventViewer.set_TabIndex(4);
        this.cursorEventViewer.set_View(System.Windows.Forms.View.List);
        // Set up how the form should be displayed and add the controls to the 
        // form.
        this.set_ClientSize(new System.Drawing.Size(456, 286));
        this.get_Controls().AddRange(new System.Windows.Forms.Control[] { 
            this.label3, this.cursorEventViewer, this.label2, this.label1,
            this.testPanel, this.cursorSelectionComboBox });

        this.set_Text("Cursors Example");

        IEnumerator myEnum = CursorList().GetEnumerator();
        // Add all the cursor types to the combobox.
        while (myEnum.MoveNext()) {
            Cursor cursor = ( Cursor)myEnum.get_Current();
            cursorSelectionComboBox.get_Items().Add(cursor);
        }
    } //Form1

    private Cursor[] CursorList()
    {
        // Make an array of all the types of cursors in Windows Forms.
        return new Cursor[] { Cursors.get_AppStarting(), Cursors.get_Arrow(), 
            Cursors.get_Cross(), Cursors.get_Default(), Cursors.get_Hand(), 
            Cursors.get_Help(), Cursors.get_HSplit(), Cursors.get_IBeam(), 
            Cursors.get_No(), Cursors.get_NoMove2D(), Cursors.get_NoMoveHoriz(), 
            Cursors.get_NoMoveVert(), Cursors.get_PanEast(), 
            Cursors.get_PanNE(), Cursors.get_PanNorth(), Cursors.get_PanNW(),
            Cursors.get_PanSE(), Cursors.get_PanSouth(), Cursors.get_PanSW(),
            Cursors.get_PanWest(), Cursors.get_SizeAll(), 
            Cursors.get_SizeNESW(), Cursors.get_SizeNS(), 
            Cursors.get_SizeNWSE(), Cursors.get_SizeWE(), 
            Cursors.get_UpArrow(), Cursors.get_VSplit(), 
            Cursors.get_WaitCursor() };
    } //CursorList

    private void cursorSelectionComboBox_SelectedIndexChanged(Object sender,
        System.EventArgs e)
    {
        // Set the cursor in the test panel to be the selected cursor style.
        testPanel.set_Cursor((Cursor)(cursorSelectionComboBox.
            get_SelectedItem()));
    } //cursorSelectionComboBox_SelectedIndexChanged

    private void testPanel_CursorChanged(Object sender, System.EventArgs e)
    {
        // Build up a string containing the type of object sending the event, 
        // and the event.
        String cursorEvent = String.Format("[{0}]: {1}", 
               sender.GetType().ToString(), "Cursor changed");
        // Record this event in the list view.
        this.cursorEventViewer.get_Items().Add(cursorEvent);
    } //testPanel_CursorChanged
} //Form1

The following example draws the specified cursor on the form in its normal size, and in stretched mode, twice its size. This example assumes that you have a Form and a Cursor object to pass into the method when it is called.

Private Sub DrawCursorsOnForm(cursor As Cursor)
   ' If the form's cursor is not the Hand cursor and the 
   ' Current cursor is the Default, Draw the specified 
   ' cursor on the form in normal size and twice normal size. 
   If (Not Me.Cursor.Equals(Cursors.Hand)) And _
     Cursor.Current.Equals(Cursors.Default) Then

      ' Draw the cursor stretched.
      Dim graphics As Graphics = Me.CreateGraphics()
      Dim rectangle As New Rectangle(New Point(10, 10), _
        New Size(cursor.Size.Width * 2, cursor.Size.Height * 2))
      cursor.DrawStretched(graphics, rectangle)
     
      ' Draw the cursor in normal size.
      rectangle.Location = New Point(rectangle.Width + _
        rectangle.Location.X, rectangle.Height + rectangle.Location.Y)
      rectangle.Size = cursor.Size
      cursor.Draw(graphics, rectangle)

      ' Dispose of the cursor.
      cursor.Dispose()
   End If
End Sub

private void DrawCursorsOnForm(Cursor cursor)
{
    // If the form's cursor is not the Hand cursor and the 
    // Current cursor is the Default, Draw the specified 
    // cursor on the form in normal size and twice normal size.
        if (!(this.get_Cursor().Equals(Cursors.get_Hand())) 
            & get_Cursor().get_Current().Equals(Cursors.get_Default())) {
        // Draw the cursor stretched.
        Graphics graphics = this.CreateGraphics();
        Rectangle rectangle = new Rectangle(new Point(10, 10), 
            new Size(cursor.get_Size().get_Width() * 2, 
            cursor.get_Size().get_Height() * 2));
        cursor.DrawStretched(graphics, rectangle);
        // Draw the cursor in normal size.
        rectangle.set_Location(new Point(rectangle.get_Width() 
            + rectangle.get_Location().get_X(), rectangle.get_Height() 
            + rectangle.get_Location().get_Y()));
        rectangle.set_Size(cursor.get_Size());
        cursor.Draw(graphics, rectangle);
        // Dispose of the cursor.
        cursor.Dispose();
    }
} //DrawCursorsOnForm

System.Object
  System.Windows.Forms.Cursors

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show: