Control.Cursor プロパティ

定義

マウス ポインターがコントロールの上にあるときに表示されるカーソルを取得または設定します。Gets or sets the cursor that is displayed when the mouse pointer is over the control.

public:
 virtual property System::Windows::Forms::Cursor ^ Cursor { System::Windows::Forms::Cursor ^ get(); void set(System::Windows::Forms::Cursor ^ value); };
public virtual System.Windows.Forms.Cursor Cursor { get; set; }
member this.Cursor : System.Windows.Forms.Cursor with get, set
Public Overridable Property Cursor As Cursor

プロパティ値

マウス ポインターがコントロールの上にあるときに表示されるカーソルを表す CursorA Cursor that represents the cursor to display when the mouse pointer is over the control.

次のコード例では、ユーザーの使用可能な論理ドライブを使用して ComboBox を設定します。The following code example fills a ComboBox with the user's available logical drives. また、この例では、コンボボックスの Cursor プロパティを設定して、マウスポインターがドロップダウンボタンの上にあるときに Cursors.Hand カーソルが表示されるようにします。The example also sets the combo box's Cursor property so the Cursors.Hand cursor is displayed when the mouse pointer is over the drop-down button. このコードでは、ComboBox を持つ Form が必要です。This code requires that you have a Form with a ComboBox on it.

private:
   void Form1_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      // Display the hand cursor when the mouse pointer
      // is over the combo box drop-down button.
      comboBox1->Cursor = Cursors::Hand;
      
      // Fill the combo box with all the logical
      // drives available to the user.
      try
      {
         IEnumerator^ myEnum = Environment::GetLogicalDrives()->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            String^ logicalDrive = safe_cast<String^>(myEnum->Current);
            comboBox1->Items->Add( logicalDrive );
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }
private void Form1_Load(object sender, EventArgs e)
{
   // Display the hand cursor when the mouse pointer
   // is over the combo box drop-down button. 
   comboBox1.Cursor = Cursors.Hand;

   // Fill the combo box with all the logical 
   // drives available to the user.
   try
   {
      foreach(string logicalDrive in Environment.GetLogicalDrives() )
      {
         comboBox1.Items.Add(logicalDrive);
      }
   }
   catch(Exception ex)
   {
      MessageBox.Show(ex.Message);
   }
}
Private Sub Form1_Load(sender As Object, _
  e As EventArgs) Handles MyBase.Load
   ' Display the hand cursor when the mouse pointer
   ' is over the combo box drop-down button. 
   comboBox1.Cursor = Cursors.Hand
   
   ' Fill the combo box with all the logical 
   ' drives available to the user. 
   Try
      Dim logicalDrive As String
      For Each logicalDrive In  Environment.GetLogicalDrives()
         comboBox1.Items.Add(logicalDrive)
      Next logicalDrive
   Catch ex As Exception
      MessageBox.Show(ex.Message)
   End Try
End Sub

注釈

コントロールの Cursor プロパティに Cursor を割り当てて、マウスポインターがコントロールの上にあるときに表示されるカーソルを変更します。Assign a Cursor to the Cursor property of the control to change the cursor displayed when the mouse pointer is over the control. アプリケーションのすべてのコントロールに対してマウスカーソルを一時的に変更するには、Cursor.Current プロパティを設定します。To temporarily change the mouse cursor for all controls on your application set the Cursor.Current property. 通常は、ComboBox を設定するとき、またはファイルを保存または読み込むときに、Cursor.Current プロパティを待機カーソルに設定します。Typically you would set the Cursor.Current property to a wait cursor when populating a ComboBox or saving or loading a file.

Cursor プロパティはアンビエントプロパティです。The Cursor property is an ambient property. アンビエントプロパティは、設定されていない場合、親コントロールから取得されるコントロールプロパティです。An ambient property is a control property that, if not set, is retrieved from the parent control. たとえば、Button は、既定では親 Form と同じ BackColor を持ちます。For example, a Button will have the same BackColor as its parent Form by default. アンビエントプロパティの詳細については、「AmbientProperties クラス」または「Control クラスの概要」を参照してください。For more information about ambient properties, see the AmbientProperties class or the Control class overview.

注意 (継承者)

派生クラスの Cursor プロパティをオーバーライドする場合は、基本クラスの Cursor プロパティを使用して、基本実装を拡張します。When overriding the Cursor property in a derived class, use the base class's Cursor property to extend the base implementation. それ以外の場合は、すべての実装を指定する必要があります。Otherwise, you must provide all the implementation. Cursor プロパティの getset の両方のメソッドをオーバーライドする必要はありません。必要に応じて、オーバーライドできるのは1つだけです。You are not required to override both the get and set methods of the Cursor property; you can override only one if needed.

セキュリティ

UIPermission
セーフサブウィンドウでこのプロパティ値を設定します。for safe subwindows to set this property value. 関連付けられた列挙型: SafeSubWindowsAssociated enumeration: SafeSubWindows

適用対象

こちらもご覧ください