Cursor 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 Cursor 類別的新執行個體。
多載
| 名稱 | Description |
|---|---|
| Cursor(IntPtr) |
從指定的 Windows 句柄初始化該 Cursor 類別的新實例。 |
| Cursor(Stream) |
從指定的資料流中初始化該類別的新實例 Cursor 。 |
| Cursor(String) |
從指定檔案初始化該類別的新實例 Cursor 。 |
| Cursor(Type, String) |
初始化該類別的新實例 Cursor ,來自指定資源的資源類型。 |
Cursor(IntPtr)
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
從指定的 Windows 句柄初始化該 Cursor 類別的新實例。
public:
Cursor(IntPtr handle);
public Cursor(IntPtr handle);
new System.Windows.Forms.Cursor : nativeint -> System.Windows.Forms.Cursor
Public Sub New (handle As IntPtr)
參數
例外狀況
handle 是 Zero。
範例
以下程式碼範例將游標的 Current , 建立一個游標,改變 Handle其位置與裁切矩形。 結果是游標會從執行程式碼時的位置往上移動並向左移動 50 像素。 此外,游標的裁切矩形會被改成表單的邊界(預設是使用者的整個畫面)。 這個範例要求你有 a Form 和 a Button 來在點擊時呼叫這個程式碼。
void MoveCursor()
{
// Set the Current cursor, move the cursor's Position,
// and set its clipping rectangle to the form.
this->Cursor = gcnew System::Windows::Forms::Cursor( ::Cursor::Current->Handle );
::Cursor::Position = Point(::Cursor::Position.X - 50,::Cursor::Position.Y - 50);
::Cursor::Clip = Rectangle(this->Location,this->Size);
}
private void MoveCursor()
{
// Set the Current cursor, move the cursor's Position,
// and set its clipping rectangle to the form.
this.Cursor = new Cursor(Cursor.Current.Handle);
Cursor.Position = new Point(Cursor.Position.X - 50, Cursor.Position.Y - 50);
Cursor.Clip = new Rectangle(this.Location, this.Size);
}
Private Sub MoveCursor()
' Set the Current cursor, move the cursor's Position,
' and set its clipping rectangle to the form.
Me.Cursor = New Cursor(Cursor.Current.Handle)
Cursor.Position = New Point(Cursor.Position.X - 50, Cursor.Position.Y - 50)
Cursor.Clip = New Rectangle(Me.Location, Me.Size)
End Sub
備註
完成後必須釋放游標。 欲了解更多關於資源處置的資訊,請參閱 「清理未管理資源」。
適用於
Cursor(Stream)
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
從指定的資料流中初始化該類別的新實例 Cursor 。
public:
Cursor(System::IO::Stream ^ stream);
public Cursor(System.IO.Stream stream);
new System.Windows.Forms.Cursor : System.IO.Stream -> System.Windows.Forms.Cursor
Public Sub New (stream As Stream)
參數
範例
以下程式碼範例是從 Stream 以 的方法OpenFile所建立OpenFileDialog的 載入游標。 當方法被呼叫時,會顯示給 OpenFileDialog 使用者,當 a. 選取 CUR 檔案並關閉對話框,開啟該檔案並 Stream 回 Cursor傳 。
private:
void SetCursor()
{
// Display an OpenFileDialog so the user can select a cursor.
OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;
openFileDialog1->Filter = "Cursor Files|*.cur";
openFileDialog1->Title = "Select a Cursor File";
openFileDialog1->ShowDialog();
// If a .cur file was selected, open it.
if ( !openFileDialog1->FileName->Equals( "" ) )
{
// Assign the cursor in the stream to the form's Cursor property.
this->Cursor = gcnew System::Windows::Forms::Cursor( openFileDialog1->OpenFile() );
}
}
private void SetCursor()
{
// Display an OpenFileDialog so the user can select a cursor.
OpenFileDialog openFileDialog1 = new OpenFileDialog();
openFileDialog1.Filter = "Cursor Files|*.cur";
openFileDialog1.Title = "Select a Cursor File";
openFileDialog1.ShowDialog();
// If a .cur file was selected, open it.
if(openFileDialog1.FileName != "")
{
// Assign the cursor in the stream to the form's Cursor property.
this.Cursor = new Cursor(openFileDialog1.OpenFile());
}
}
Private Sub SetCursor()
' Display an OpenFileDialog so the user can select a Cursor.
Dim openFileDialog1 As New OpenFileDialog()
openFileDialog1.Filter = "Cursor Files|*.cur"
openFileDialog1.Title = "Select a Cursor File"
openFileDialog1.ShowDialog()
' If a .cur file was selected, open it.
If openFileDialog1.FileName <> "" Then
' Assign the cursor in the stream to the form's Cursor property.
Me.Cursor = New Cursor(openFileDialog1.OpenFile())
End If
End Sub
備註
指定的 stream 資料串流必須包含游標(.cur)檔案。
Note
該類別不支援 Cursor 動畫游標(.ani檔案)。
另請參閱
適用於
Cursor(String)
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
從指定檔案初始化該類別的新實例 Cursor 。
public:
Cursor(System::String ^ fileName);
public Cursor(string fileName);
new System.Windows.Forms.Cursor : string -> System.Windows.Forms.Cursor
Public Sub New (fileName As String)
參數
- fileName
- String
要載入游標檔案。
範例
以下程式碼範例以控制方式顯示客戶資訊 TreeView 。 根樹節點顯示客戶名稱,子樹節點則顯示分配給每位客戶的訂單號碼。 在此範例中,顯示 1,000 名客戶,每人有 15 筆訂單。 重新上色 TreeView 會被使用 BeginUpdate and EndUpdate 方法抑制,並顯示等待 Cursor 畫面,等待物件 TreeView 的建立與上色 TreeNode 。 這個例子要求你有一個 Customer 物件可以容納一組 Order 物件。 同時也要求你在 上TreeView建立了一個控制實例Form。
// 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
備註
參數 fileName 必須參考標準游標(.cur)檔案。
Note
該類別不支援 Cursor 動畫游標(.ani檔案)。
適用於
Cursor(Type, String)
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
- 來源:
- Cursor.cs
初始化該類別的新實例 Cursor ,來自指定資源的資源類型。
public:
Cursor(Type ^ type, System::String ^ resource);
public Cursor(Type type, string resource);
new System.Windows.Forms.Cursor : Type * string -> System.Windows.Forms.Cursor
Public Sub New (type As Type, resource As String)
參數
- resource
- String
資源名稱。
範例
以下程式碼範例展示了一個表單,示範使用 Cursor 建構子使用自訂游標。 自訂 Cursor 設定嵌入在應用程式的資源檔案中。 這個範例要求你有一個游標包含在一個名為 MyCursor.cur的游標檔案中。 若要使用命令列編譯此範例,請加入以下標記: /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
備註
以下是如何在應用程式中嵌入游標作為資源的範例。 要嵌入資源,先引用資源名稱後加上逗號,然後是完整的組合語言路徑。 請參閱範例章節,了解如何從嵌入的資源載入游標。
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
Note
無論是編譯時還是在程式碼中引用資源,對 C# 和 Visual Basic 編譯器來說都是大小寫區分的。