UIElement.ManipulationStarting Zdarzenie

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

Występuje po pierwszym utworzeniu procesora manipulowania.

public:
 event EventHandler<System::Windows::Input::ManipulationStartingEventArgs ^> ^ ManipulationStarting;

public event EventHandler<System.Windows.Input.ManipulationStartingEventArgs> ManipulationStarting;

member this.ManipulationStarting : EventHandler<System.Windows.Input.ManipulationStartingEventArgs> 

Public Custom Event ManipulationStarting As EventHandler(Of ManipulationStartingEventArgs) 

Typ zdarzenia

EventHandler<ManipulationStartingEventArgs>

Przykłady

W poniższym przykładzie przedstawiono procedurę obsługi zdarzeń dla ManipulationStarting zdarzenia i ustawia ManipulationContainer element nadrzędny, który odbiera zdarzenia manipulowania, tak aby współrzędne manipulacji miały wartość względem elementu nadrzędnego. Ten przykład jest częścią większego przykładu w przewodniku: tworzenie pierwszej aplikacji dotykowej.

void Window_ManipulationStarting(object sender, ManipulationStartingEventArgs e)
{
    e.ManipulationContainer = this;
    e.Handled = true;
}

Private Sub Window_ManipulationStarting(ByVal sender As Object, ByVal e As ManipulationStartingEventArgs)
    e.ManipulationContainer = Me
    e.Handled = True
End Sub

Uwagi

Zdarzenie ManipulationStarting występuje na elemecie, który ma IsManipulationEnabled właściwość ustawioną na true wartość, gdy użytkownik umieści na nim palec. Domyślnie kolejne zdarzenia manipulowania zgłaszają położenie manipulacji względem elementu, który ma IsManipulationEnabled ustawioną wartość true. Możesz określić, że pozycja powinna być względna względem innego elementu, ustawiając ManipulationContainer właściwość. Na przykład można dokonać manipulacji względem elementu nadrzędnego elementu.

Możesz również wykonać następujące czynności w procedurze obsługi zdarzeń dla ManipulationStartingprogramu :

• Określ, czy użytkownik potrzebuje więcej niż jednego palca do wykonania manipulacji, ustawiając ManipulationStartingEventArgs.IsSingleTouchEnabled właściwość.

• Określ, które typy manipulacji są włączone, ustawiając ManipulationStartingEventArgs.Mode właściwość na ManipulationModes wyliczenie.

• Określ środek rotacji pojedynczego palca, ustawiając ManipulationStartingEventArgs.Pivot właściwość .

• Anuluj manipulację, wywołując metodę ManipulationStartingEventArgs.Cancel .

Aby uzyskać więcej informacji na temat manipulacji, zobacz Omówienie danych wejściowych. Przykład aplikacji, która reaguje na manipulacje, zobacz Przewodnik: tworzenie pierwszej aplikacji dotykowej.

Informacje dotyczące kierowanego zdarzenia

Pole identyfikatora	ManipulationStartingEvent
Strategia routingu	Propagacji
Delegat	EventHandler<TEventArgs> typu ManipulationStartingEventArgs.