UIElement.IsMouseCaptured UIElement.IsMouseCaptured UIElement.IsMouseCaptured UIElement.IsMouseCaptured Property

定義

この要素にマウスがキャプチャされるかどうかを示す値を取得します。Gets a value indicating whether the mouse is captured to this element. これは依存関係プロパティです。This is a dependency property.

public:
 property bool IsMouseCaptured { bool get(); };
public bool IsMouseCaptured { get; }
member this.IsMouseCaptured : bool
Public ReadOnly Property IsMouseCaptured As Boolean

プロパティ値

要素にマウス キャプチャがある場合は true。それ以外の場合は falsetrue if the element has mouse capture; otherwise, false. 既定値は、false です。The default is false.

実装

次の例では、マウスが要素に対して既にキャプチャされているかどうかに基づいて、マウスキャプチャの状態をオンまたはオフにします。The following example turns the mouse capture state on or off based on whether the mouse is already captured for the element.

マウスキャプチャが他の場所にある場合は、その要素にマウスのキャプチャが設定されます。If mouse capture is elsewhere, the mouse capture is set to that element. 要素にマウスキャプチャがある場合は、null 入力をMouse.Capture使用してを呼び出すことによってクリアされます。If the element had mouse capture, it is cleared by calling Mouse.Capture with a null input.

private void CaptureMouseCommandExecuted(object sender, ExecutedRoutedEventArgs e)
{
    MessageBox.Show("Mouse Command");
    IInputElement target = Mouse.DirectlyOver;

    target = target as Control;
    if (target != null)
    {
        if (!target.IsMouseCaptured)
        {
            Mouse.Capture(target);
        }
        else
        {
            Mouse.Capture(null);
        }
    }
}
Private Sub CaptureMouseCommandExecuted(ByVal sender As Object, ByVal e As ExecutedRoutedEventArgs)
    MessageBox.Show("Mouse Command")
    Dim target As IInputElement = Mouse.DirectlyOver

    target = TryCast(target, Control)
    If target IsNot Nothing Then
        If Not target.IsMouseCaptured Then
            Mouse.Capture(target)
        Else
            Mouse.Capture(Nothing)
        End If
    End If
End Sub

注釈

マウスキャプチャの状態は、インプロセスのドラッグアンドドロップ操作に関連しています。Mouse capture state is related to in-process drag-and-drop operations.

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

識別子フィールドIdentifier field IsMouseCapturedProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone

適用対象

こちらもご覧ください