FrameworkContentElement.Cursor FrameworkContentElement.Cursor FrameworkContentElement.Cursor FrameworkContentElement.Cursor Property


この要素上にマウス ポインターが置かれたときに表示されるカーソルを取得または設定します。Gets or sets the cursor that displays when the mouse pointer is over this element.

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


表示対象のカーソル。The cursor to display. 既定値はこの依存関係プロパティごとに null として定義されます。The default value is defined as null per this dependency property. ただし、実行時における実用的な既定値は、さまざまな要因から取得されます。However, the practical default at run time will come from a variety of factors.

次の例では、カーソルをカスタム値に設定します。The following example sets the cursor to a custom value.

private void CursorTypeChanged(object sender, SelectionChangedEventArgs e)
    ComboBox source = e.Source as ComboBox;

    if (source != null)
        ComboBoxItem selectedCursor = source.SelectedItem as ComboBoxItem;

        // Changing the cursor of the Border control 
        // by setting the Cursor property
        switch (selectedCursor.Content.ToString())
            case "AppStarting":
                DisplayArea.Cursor = Cursors.AppStarting;
            case "ArrowCD":                        
                DisplayArea.Cursor = Cursors.ArrowCD;
            case "Arrow":
                DisplayArea.Cursor = Cursors.Arrow;
            case "Cross":
                DisplayArea.Cursor = Cursors.Cross;
            case "HandCursor":
                DisplayArea.Cursor = Cursors.Hand;
            case "Help":
                DisplayArea.Cursor = Cursors.Help;
            case "IBeam":
                DisplayArea.Cursor = Cursors.IBeam;
            case "No":
                DisplayArea.Cursor = Cursors.No;
            case "None":
                DisplayArea.Cursor = Cursors.None;
            case "Pen":
                DisplayArea.Cursor = Cursors.Pen;
            case "ScrollSE":
                DisplayArea.Cursor = Cursors.ScrollSE;
            case "ScrollWE":
                DisplayArea.Cursor = Cursors.ScrollWE;
            case "SizeAll":
                DisplayArea.Cursor = Cursors.SizeAll;
            case "SizeNESW":
                DisplayArea.Cursor = Cursors.SizeNESW;
            case "SizeNS":
                DisplayArea.Cursor = Cursors.SizeNS;
            case "SizeNWSE":
                DisplayArea.Cursor = Cursors.SizeNWSE;
            case "SizeWE":
                DisplayArea.Cursor = Cursors.SizeWE;
            case "UpArrow":
                DisplayArea.Cursor = Cursors.UpArrow;
            case "WaitCursor":
                DisplayArea.Cursor = Cursors.Wait;
            case "Custom":
                DisplayArea.Cursor = CustomCursor;

        // If the cursor scope is set to the entire application
        // Use OverrideCursor to force the cursor for all elements
        if (cursorScopeElementOnly == false)
            Mouse.OverrideCursor = DisplayArea.Cursor;
' When the Radiobox changes, a new cursor type is set
Private Sub CursorTypeChanged(ByVal sender As Object, ByVal e As SelectionChangedEventArgs)

    Dim item As String = CType(e.Source, ComboBox).SelectedItem.Content.ToString()

    Select Case item
        Case "AppStarting"
            DisplayArea.Cursor = Cursors.AppStarting
        Case "ArrowCD"
            DisplayArea.Cursor = Cursors.ArrowCD
        Case "Arrow"
            DisplayArea.Cursor = Cursors.Arrow
        Case "Cross"
            DisplayArea.Cursor = Cursors.Cross
        Case "HandCursor"
            DisplayArea.Cursor = Cursors.Hand
        Case "Help"
            DisplayArea.Cursor = Cursors.Help
        Case "IBeam"
            DisplayArea.Cursor = Cursors.IBeam
        Case "No"
            DisplayArea.Cursor = Cursors.No
        Case "None"
            DisplayArea.Cursor = Cursors.None
        Case "Pen"
            DisplayArea.Cursor = Cursors.Pen
        Case "ScrollSE"
            DisplayArea.Cursor = Cursors.ScrollSE
        Case "ScrollWE"
            DisplayArea.Cursor = Cursors.ScrollWE
        Case "SizeAll"
            DisplayArea.Cursor = Cursors.SizeAll
        Case "SizeNESW"
            DisplayArea.Cursor = Cursors.SizeNESW
        Case "SizeNS"
            DisplayArea.Cursor = Cursors.SizeNS
        Case "SizeNWSE"
            DisplayArea.Cursor = Cursors.SizeNWSE
        Case "SizeWE"
            DisplayArea.Cursor = Cursors.SizeWE
        Case "UpArrow"
            DisplayArea.Cursor = Cursors.UpArrow
        Case "WaitCursor"
            DisplayArea.Cursor = Cursors.Wait
        Case "Custom"
            DisplayArea.Cursor = CustomCursor
    End Select

    ' if the cursor scope is set to the entire application
    ' use OverrideCursor to force the cursor for all elements
    If (cursorScopeElementOnly = False) Then
        Mouse.OverrideCursor = DisplayArea.Cursor
    End If

End Sub


このプロパティを設定するとXAMLXAMLXAMLXAMLプロセッサに依存の型変換をCursorクラス文字列を評価します。When setting this property in XAMLXAML, the XAMLXAML processor relies on type conversion for the Cursor class to evaluate the string. 指定された文字列に評価、CursorType値。The provided string should evaluate to a CursorType value. 詳細については、「Cursor」を参照してください。See Cursor for details.

このプロパティによって確立されると、カーソルは、マウス ポインターがこの要素は表示されないかどうかの値に依存しても、ForceCursorプロパティ。Whether the cursor as established by this property will or will not display when the mouse pointer is over this element is also dependent on the value of the ForceCursor property. また、イベント関連の考慮事項など、アクティブなドラッグ、マウスのキャプチャ、テキスト編集コントロール、および、内のモードでは、このプロパティで指定した値よりも優先順位の高いカーソルは影響はも。Also, event-related considerations such as an active drag, mouse capture, text editing modes within controls, and so on, will also affect the cursor with higher priority than the value you specify in this property.

最終的な既定値にこのプロパティの設定の動作を元に戻すに設定nullもう一度です。To revert the behavior of setting this property to the eventual default, set it to null again.

null実際的なカーソルの値の決定はここでは遅延し、別の場所から取得する必要が本当に既定値を意味します。The null default really means that determination of the practical cursor value is deferred here and should be obtained from elsewhere. プログラムによる既定のカーソルの任意のソースから値を持たない経由で表示される場合、Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)アプリケーションは矢印になります。If presented with no programmatic values from any source, the default cursor over a Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) application will be an arrow.

上にマウスが移動するたび、WPFWPFが発生するQueryCursorイベント。Each movement of the mouse over a WPFWPF application raises a QueryCursor event. イベント バブルにおよび、経路上の任意の要素は、イベントを処理し、このイベントの引数を使用してカーソルの値を設定する機会を持ちます。The event bubbles, and any element along the route has the opportunity to handle the event and to set the value of the cursor via the arguments of this event. その場合は、イベントが処理されますと、引数には、変更された値よりも優先の値、Cursor任意のレベルでは、プロパティしない限り、ForceCursor設定されます。If that happens, the fact that the event is handled and has a changed value in the arguments takes precedence over the value of the Cursor property at any level, unless ForceCursor is set.

カスタム カーソルを作成しない場合は、通常このプロパティ設定するの静的プロパティの値をCursorsクラス。If not creating a custom cursor, typically you set this property to a static property value of the Cursors class.

設定、Cursorにカスタム値が有効でない部分信頼でします。Setting the Cursor to a custom value is not enabled in partial trust. カスタムのカーソルの詳細については、次を参照してください。入力の概要します。For more information on custom cursors, see Input Overview.

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field CursorProperty
メタデータのプロパティを設定するには trueMetadata properties set to true NoneNone