Cursor Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Fare işaretçisini boyamak için kullanılan görüntüyü temsil eder.

public ref class Cursor sealed : IDisposable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.CursorConverter))]
[System.Serializable]
public sealed class Cursor : IDisposable, System.Runtime.Serialization.ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.CursorConverter))]
public sealed class Cursor : IDisposable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.CursorConverter))>]
[<System.Serializable>]
type Cursor = class
    interface IDisposable
    interface ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.CursorConverter))>]
type Cursor = class
    interface IDisposable
    interface ISerializable

Public NotInheritable Class Cursor
Implements IDisposable, ISerializable

Devralma

Object

Cursor

Öznitelikler

TypeConverterAttribute SerializableAttribute

Uygulamalar

IDisposable ISerializable

Örnekler

Aşağıdaki kod örneği, özel bir imleç kullanmayı gösteren bir form görüntüler. Özel Cursor , uygulamanın kaynak dosyasına eklenir. Örnek, adlı MyCursor.curbir imleç dosyasında bulunan bir imleç gerektirir. Bu örneği komut satırını kullanarak derlemek için aşağıdaki bayrağı ekleyin: /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");  
        }
    }
}

Imports System.Drawing
Imports System.Windows.Forms

Namespace CustomCursor
   
   Public Class Form1
      Inherits System.Windows.Forms.Form
      
      <System.STAThread()> _
      Public Shared Sub Main()
         System.Windows.Forms.Application.Run(New Form1())
      End Sub

      Public Sub New()

         Me.ClientSize = New System.Drawing.Size(292, 266)
         Me.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.
        Me.Cursor = New Cursor(Me.GetType(), "MyCursor.cur")
      End Sub
   End Class
End Namespace 'CustomCursor

Aşağıdaki kod örneği bir TreeView denetimde müşteri bilgilerini görüntüler. Kök ağaç düğümleri müşteri adlarını, alt ağaç düğümleri ise her müşteriye atanan sipariş numaralarını görüntüler. Bu örnekte, her birinde 15 sipariş olan 1.000 müşteri görüntülenir. ve yöntemleri kullanılarak BeginUpdate EndUpdate öğesinin yeniden boyanmış TreeView olması gizleniyor ve nesneler oluşturulurken ve boyanırken TreeNode TreeView bir bekleme Cursor görüntülenir. Bu örnek, uygulama dizininde adlı MyWait.cur bir imleç dosyanız olmasını gerektirir. Ayrıca, bir Customer nesne koleksiyonunu Order barındırabilen ve üzerinde Formbir denetimin örneğini oluşturduğunuz bir TreeView nesne gerektirir.

// The basic Customer class.
ref class Customer: public System::Object
{
private:
   String^ custName;

protected:
   ArrayList^ custOrders;

public:
   Customer( String^ customername )
   {
      custName = "";
      custOrders = gcnew ArrayList;
      this->custName = customername;
   }


   property String^ CustomerName 
   {
      String^ get()
      {
         return this->custName;
      }

      void set( String^ value )
      {
         this->custName = value;
      }

   }

   property ArrayList^ CustomerOrders 
   {
      ArrayList^ get()
      {
         return this->custOrders;
      }

   }

};


// End Customer class
// The basic customer Order class.
ref class Order: public System::Object
{
private:
   String^ ordID;

public:
   Order( String^ orderid )
   {
      ordID = "";
      this->ordID = orderid;
   }


   property String^ OrderID 
   {
      String^ get()
      {
         return this->ordID;
      }

      void set( String^ value )
      {
         this->ordID = value;
      }

   }

};
// End Order class



void FillMyTreeView()
{
   // Add customers to the ArrayList of Customer objects.
   for ( int x = 0; x < 1000; x++ )
   {
      customerArray->Add( gcnew Customer( "Customer " + x ) );
   }
   
   // Add orders to each Customer object in the ArrayList.
   IEnumerator^ myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ customer1 = safe_cast<Customer^>(myEnum->Current);
      for ( int y = 0; y < 15; y++ )
      {
         customer1->CustomerOrders->Add( gcnew Order( "Order " + y ) );
      }
   }

   // Display a wait cursor while the TreeNodes are being created.
   ::Cursor::Current = gcnew System::Windows::Forms::Cursor( "MyWait.cur" );
   
   // Suppress repainting the TreeView until all the objects have been created.
   treeView1->BeginUpdate();
   
   // Clear the TreeView each time the method is called.
   treeView1->Nodes->Clear();
   
   // Add a root TreeNode for each Customer object in the ArrayList.
   myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ customer2 = safe_cast<Customer^>(myEnum->Current);
      treeView1->Nodes->Add( gcnew TreeNode( customer2->CustomerName ) );
      
      // Add a child treenode for each Order object in the current Customer object.
      IEnumerator^ myEnum = customer2->CustomerOrders->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Order^ order1 = safe_cast<Order^>(myEnum->Current);
         treeView1->Nodes[ customerArray->IndexOf( customer2 ) ]->Nodes->Add( gcnew TreeNode( customer2->CustomerName + "." + order1->OrderID ) );
      }
   }
   
   // Reset the cursor to the default for all controls.
   ::Cursor::Current = Cursors::Default;
   
   // Begin repainting the TreeView.
   treeView1->EndUpdate();
}

// The basic Customer class.
public class Customer : System.Object
{
   private string custName = "";
   protected ArrayList custOrders = new ArrayList();

   public Customer(string customername)
   {
      this.custName = customername;
   }

   public string CustomerName
   {      
      get{return this.custName;}
      set{this.custName = value;}
   }

   public ArrayList CustomerOrders 
   {
      get{return this.custOrders;}
   }
} // End Customer class 

// The basic customer Order class.
public class Order : System.Object
{
   private string ordID = "";

   public Order(string orderid)
   {
      this.ordID = orderid;
   }

   public string OrderID
   {      
      get{return this.ordID;}
      set{this.ordID = value;}
   }
} // End Order class

// Create a new ArrayList to hold the Customer objects.
private ArrayList customerArray = new ArrayList(); 

private void FillMyTreeView()
{
   // Add customers to the ArrayList of Customer objects.
   for(int x=0; x<1000; x++)
   {
      customerArray.Add(new Customer("Customer" + x.ToString()));
   }

   // Add orders to each Customer object in the ArrayList.
   foreach(Customer customer1 in customerArray)
   {
      for(int y=0; y<15; y++)
      {
         customer1.CustomerOrders.Add(new Order("Order" + y.ToString()));    
      }
   }

   // Display a wait cursor while the TreeNodes are being created.
   Cursor.Current = new Cursor("MyWait.cur");
        
   // Suppress repainting the TreeView until all the objects have been created.
   treeView1.BeginUpdate();

   // Clear the TreeView each time the method is called.
   treeView1.Nodes.Clear();

   // Add a root TreeNode for each Customer object in the ArrayList.
   foreach(Customer customer2 in customerArray)
   {
      treeView1.Nodes.Add(new TreeNode(customer2.CustomerName));
          
      // Add a child treenode for each Order object in the current Customer object.
      foreach(Order order1 in customer2.CustomerOrders)
      {
         treeView1.Nodes[customerArray.IndexOf(customer2)].Nodes.Add(
           new TreeNode(customer2.CustomerName + "." + order1.OrderID));
      }
   }

   // Reset the cursor to the default for all controls.
   Cursor.Current = Cursors.Default;

   // Begin repainting the TreeView.
   treeView1.EndUpdate();
}

Public Class Customer
   Inherits [Object]
   Private custName As String = ""
   Friend custOrders As New ArrayList()

   Public Sub New(ByVal customername As String)
      Me.custName = customername
   End Sub

   Public Property CustomerName() As String
      Get
         Return Me.custName
      End Get
      Set(ByVal Value As String)
         Me.custName = Value
      End Set
   End Property

   Public ReadOnly Property CustomerOrders() As ArrayList
      Get
         Return Me.custOrders
      End Get
   End Property
End Class


Public Class Order
   Inherits [Object]
   Private ordID As String

   Public Sub New(ByVal orderid As String)
      Me.ordID = orderid
   End Sub

   Public Property OrderID() As String
      Get
         Return Me.ordID
      End Get
      Set(ByVal Value As String)
         Me.ordID = Value
      End Set
   End Property
End Class

' Create a new ArrayList to hold the Customer objects.
Private customerArray As New ArrayList()

Private Sub FillMyTreeView()
   ' Add customers to the ArrayList of Customer objects.
   Dim x As Integer
   For x = 0 To 999
      customerArray.Add(New Customer("Customer" + x.ToString()))
   Next x

   ' Add orders to each Customer object in the ArrayList.
   Dim customer1 As Customer
   For Each customer1 In customerArray
      Dim y As Integer
      For y = 0 To 14
         customer1.CustomerOrders.Add(New Order("Order" + y.ToString()))
      Next y
   Next customer1

   ' Display a wait cursor while the TreeNodes are being created.
   Cursor.Current = New Cursor("MyWait.cur")

   ' Suppress repainting the TreeView until all the objects have been created.
   treeView1.BeginUpdate()

   ' Clear the TreeView each time the method is called.
   treeView1.Nodes.Clear()

   ' Add a root TreeNode for each Customer object in the ArrayList.
   Dim customer2 As Customer
   For Each customer2 In customerArray
      treeView1.Nodes.Add(New TreeNode(customer2.CustomerName))

      ' Add a child TreeNode for each Order object in the current Customer object.
      Dim order1 As Order
      For Each order1 In customer2.CustomerOrders
         treeView1.Nodes(customerArray.IndexOf(customer2)).Nodes.Add( _
    New TreeNode(customer2.CustomerName + "." + order1.OrderID))
      Next order1
   Next customer2

   ' Reset the cursor to the default for all controls.
   Cursor.Current = System.Windows.Forms.Cursors.Default

   ' Begin repainting the TreeView.
   treeView1.EndUpdate()
End Sub

Açıklamalar

İmleç, ekrandaki konumu fare, kalem veya trackball gibi bir işaret aygıtı tarafından denetlenen küçük bir resimdir. Kullanıcı işaret eden cihazı hareket ettirdiğinde, işletim sistemi imleci uygun şekilde taşır.

Kullanıcıya farenin hangi işlemi yapacağı konusunda bilgi vermek için farklı imleç şekilleri kullanılır. Örneğin, metni düzenlerken veya seçerken genellikle bir Cursors.IBeam imleç görüntülenir. Bekleme imleci genellikle kullanıcıya bir işlemin çalışmakta olduğunu bildirmek için kullanılır. Kullanıcının beklemesini isteyebileceğiniz işlemlere örnek olarak bir dosya açma, dosya kaydetme veya gibi bir DataGridListBox denetimi veya TreeView büyük miktarda veriyle doldurma verilebilir.

sınıfından türetilen tüm denetimlerin Control bir Cursor özelliği vardır. Denetimin sınırları içindeyken fare işaretçisi tarafından görüntülenen imleci değiştirmek için, denetimin Cursor özelliğine bir Cursor atayın. Alternatif olarak, özelliğine bir Cursor Current atayarak uygulama düzeyinde imleçleri görüntüleyebilirsiniz. Örneğin, uygulamanızın amacı bir metin dosyasını düzenlemekse, herhangi bir fare olayının Current işlenmesini önlemek için dosya yüklenir veya kaydedilirken uygulamanın üzerinde bir bekleme imleci görüntüleyecek şekilde özelliğini Cursors.WaitCursor ayarlayabilirsiniz. İşlem tamamlandığında, her denetim türünün üzerinde uygun imleci görüntülemek için uygulamanın özelliğini Cursors.Default olarak ayarlayınCurrent.

Not

özelliği imlecine Current geri sıfırlamadan önce çağırırsanızApplication.DoEvents, uygulama fare olaylarını dinlemeye Cursors.Default devam eder ve uygulamadaki her denetim için uygun Cursor olan görüntülemeyi sürdürür.

İmleç nesneleri, var olan Cursorbir dosyanın, standart Cursor dosyanın, kaynağın veya veri akışının tutamacı gibi çeşitli kaynaklardan oluşturulabilir.

Not

sınıfı, Cursor animasyonlu imleçleri (.ani dosyaları) veya siyah beyaz dışındaki renklerle imleçleri desteklemez.

İmleç olarak kullandığınız resim çok küçükse, görüntüyü imlecin DrawStretched sınırlarını doldurmaya zorlamak için yöntemini kullanabilirsiniz. yöntemini çağırarak Hide imleci geçici olarak gizleyebilir ve yöntemini çağırarak Show geri yükleyebilirsiniz.

.NET Framework 4.5.2'den başlayarak, Cursor app.config dosyası aşağıdaki girişi içerdiğinde sistem DPI ayarına göre yeniden boyutlandırılır:

<appSettings>  
  <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />  
</appSettings>  

Oluşturucular

Cursor(IntPtr)	Belirtilen Windows tanıtıcısından sınıfının yeni bir örneğini Cursor başlatır.
Cursor(Stream)	Belirtilen veri akışından sınıfının yeni bir örneğini Cursor başlatır.
Cursor(String)	Belirtilen dosyadan sınıfının yeni bir örneğini Cursor başlatır.
Cursor(Type, String)	Belirtilen kaynak türüyle Cursor belirtilen kaynaktan sınıfının yeni bir örneğini başlatır.

Özellikler

Clip	İmleç için kırpma dikdörtgenini temsil eden sınırları alır veya ayarlar.
Current	Fare imlecini temsil eden bir imleç nesnesi alır veya ayarlar.
Handle	İmlecin tutamacını alır.
HotSpot	İmleci etkin noktaya alır.
Position	İmlecin konumunu alır veya ayarlar.
Size	İmleç nesnesinin boyutunu alır.
Tag	hakkında Cursorveri içeren nesneyi alır veya ayarlar.

Yöntemler

CopyHandle()	Bu Cursoröğesinin tutamacını kopyalar.
Dispose()	Cursor tarafından kullanılan tüm kaynakları serbest bırakır.
Draw(Graphics, Rectangle)	İmleci belirtilen sınırlar içinde belirtilen yüzeye çizer.
DrawStretched(Graphics, Rectangle)	İmleci belirtilen yüzey üzerinde, belirtilen sınırlar içinde esnetilmiş biçimde çizer.
Equals(Object)	Bu imlecin belirtilen Cursordeğerine eşit olup olmadığını belirten bir değer döndürür.
Finalize()	Bir nesnenin, atık toplama tarafından geri kazanılmadan önce kaynakları boşaltmaya ve diğer temizleme işlemlerini gerçekleştirmeye çalışmasına izin verir.
GetHashCode()	Geçerli Cursoriçin karma kodunu alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Hide()	İmleci gizler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Show()	İmleci görüntüler.
ToString()	Bunu Cursortemsil eden okunabilir bir dize alır.

İşleçler

Equality(Cursor, Cursor)	Sınıfının iki örneğinin Cursor eşit olup olmadığını gösteren bir değer döndürür.
Inequality(Cursor, Cursor)	Sınıfının iki örneğinin Cursor eşit olup olmadığını belirten bir değer döndürür.

Belirtik Arabirim Kullanımları

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Nesneyi serileştirir.

Ayrıca bkz.

• Cursors