UIElement.CaptureMouse Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

Próbuje wymusić przechwycenie myszy do tego elementu.

C#

public bool CaptureMouse();

Zwraca

Boolean

true jeśli mysz zostanie pomyślnie przechwycona; w przeciwnym razie , false.

Implementuje

CaptureMouse()

Przykłady

Poniższy przykład implementuje parę procedur obsługi dla kombinacji wprowadzania myszy i klawiszy, które przechwytują (i uncapture) myszy i włączają specjalny tryb myszy do wyświetlania modelu 3D.

C#

private void MouseDownHandler(object sender, MouseButtonEventArgs e)
{
    if (!Enabled) return;
    e.Handled = true;

    if (Keyboard.IsKeyDown(Key.F1))
    {
        Reset();
        return;
    }

    UIElement el = (UIElement)sender;
    _point = e.MouseDevice.GetPosition(el);
    // Initialize the center of rotation to the lookatpoint
    if (!_centered)
    {
        ProjectionCamera camera = (ProjectionCamera)_slaves[0].Camera;
        _center = camera.LookDirection;
        _centered = true;
    }

    _scaling = (e.MiddleButton == MouseButtonState.Pressed);

    if (!Keyboard.IsKeyDown(Key.Space))
        _rotating = true;
    else
        _rotating = false;

    el.CaptureMouse();
}

private void MouseUpHandler(object sender, MouseButtonEventArgs e)
{
    if (!_enabled) return;
    e.Handled = true;

    // Stuff the current initial + delta into initial so when we next move we
    // start at the right place.
    if (_rotating)
    {
        _rotation = _rotationDelta * _rotation;
    }
    else
    {
        _translate += _translateDelta;
        _translateDelta.X = 0;
        _translateDelta.Y = 0;
    }

    //_scale = _scaleDelta*_scale;
    UIElement el = (UIElement)sender;
    el.ReleaseMouseCapture();
}

Uwagi

Aby można je było przechwycić, należy włączyć element. Sprawdź, czy IsEnabled przed true wywołaniem metody jest .CaptureMouse

Jeśli wywołanie CaptureMouse zwraca truewartość , IsMouseCaptured jest również truewartością .

Jeśli wywołanie CaptureMouse zwraca truewartość , są GotMouseCapture wywoływane zdarzenia i IsMouseCapturedChanged z RoutedEventArgs.Source danymi zdarzenia zgłoszonymi jako element, w którym jest wywoływana CaptureMouse metoda. Jeśli wymusisz przechwytywanie, możesz zakłócać istniejące przechwytywanie — szczególnie w przypadku przechwytywania odnoszącego się do przeciągania i upuszczania myszą.

Aby wyczyścić przechwytywanie myszy ze wszystkich elementów, wywołaj metodę Mouse.Capture z parametrem element podanym jako null.

Dotyczy

Zobacz też

• IsMouseCaptured