Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Cursor Constructor (Type, String)

Initializes a new instance of the Cursor class from the specified resource with the specified resource type.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public Cursor(
	Type type,
	string resource
)

Parameters

type
Type: System.Type

The resource Type.

resource
Type: System.String

The name of the resource.

The following is an example of how to embed a cursor as a resource within your application. To embed the resource, reference the resource name followed by a comma, then its full assembly path. See the Example section to learn how to load the cursor from the embedded resource.

 Using the C# compiler:
 csc /resource:"MyWaitCursor.cur","MyCursors.MyWaitCursor.cur" MyCursor.cs
 Using the Visual Basic compiler:
 vbc /resource:"MyWaitCursor.cur","MyCursors.MyWaitCursor.cur" MyCursor.vb
NoteNote

The resource reference when compiling as well as when referencing it in code, is case sensitive for both the C# and Visual Basic compilers.

The following code example displays a form that demonstrates using a custom cursor by using the Cursor constructor. The custom Cursor is embedded in the application's resource file. The example requires that you have a cursor contained in a cursor file named MyCursor.cur. To compile this example using the command line, include the following flag: /res:MyCursor.Cur, CustomCursor.MyCursor.Cur

using System;
using System.Drawing;
using System.Windows.Forms;

namespace CustomCursor
{
    public class Form1 : System.Windows.Forms.Form
    {
        [STAThread]
        static void Main() 
        {
            Application.Run(new Form1());
        }

        public Form1()
        {
            this.ClientSize = new System.Drawing.Size(292, 266);
            this.Text = "Cursor Example";

            // The following generates a cursor from an embedded resource. 

            // To add a custom cursor, create a bitmap 
            //        1. Add a new cursor file to your project:  
            //                Project->Add New Item->General->Cursor File 

            // --- To make the custom cursor an embedded resource  --- 

            // In Visual Studio: 
            //        1. Select the cursor file in the Solution Explorer 
            //        2. Choose View->Properties. 
            //        3. In the properties window switch "Build Action" to "Embedded Resources" 

            // On the command line: 
            //        Add the following flag: 
            //            /res:CursorFileName.cur,Namespace.CursorFileName.cur 
            //         
            //        Where "Namespace" is the namespace in which you want to use the cursor
            //        and   "CursorFileName.cur" is the cursor filename.

            // The following line uses the namespace from the passed-in type 
            // and looks for CustomCursor.MyCursor.Cur in the assemblies manifest. 
	    // NOTE: The cursor name is acase sensitive. 
            this.Cursor = new Cursor(GetType(), "MyCursor.cur");  

        }
    }
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft