IInkOverlay::GetGestureStatus-Methode (msinkaut.h)

Ruft einen Wert ab, der bestimmt, ob das InkCollector - oder InkOverlay-Objekt an einer bestimmten Anwendungsgeste interessiert ist.

Syntax

HRESULT GetGestureStatus(
  [in]          InkApplicationGesture Gesture,
  [out, retval] VARIANT_BOOL          *Listening
);

Parameter

[in] Gesture

Die Geste, von der Sie die status möchten.

[out, retval] Listening

VARIANT_TRUE , wenn das InkCollector-Steuerelement Interesse an einer bestimmten Anwendungsgeste hat; andernfalls VARIANT_FALSE.

Diese Methode gibt einen Wert zurück, der das Interesse des InkCollector - oder InkOverlay-Objekts an einer bekannten Anwendungsgeste angibt. Wenn VARIANT_TRUE, ist das InkCollector - oder InkOverlay-Objekt an der Geste interessiert, und das Gestenereignis des InkCollector - oder InkOverlay-Objekts wird ausgelöst, wenn die Geste erkannt wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_INVALID_MODE
Der Sammlungsmodus muss sich im Gestenmodus befinden.
E_OUTOFMEMORY
Speicher kann nicht zugewiesen werden, um eine Aktion auszuführen.
E_INK_EXCEPTION
Eine Ausnahme trat auf.
E_INVALIDARG
Das Flag ist ungültig.

Hinweise

Diese Methode löst eine Ausnahme aus, wenn der Gestenparameter auf IAG_AllGestures festgelegt ist.

Um das Interesse des InkCollector- oder InkOverlay-Objekts an einer bestimmten Geste festzulegen, rufen Sie die SetGestureStatus-Methode des InkCollector- oder InkOverlay-Objekts auf.

Hinweis Standardmäßig haben die Objekte InkCollector und InkOverlay kein Interesse an den Anwendungsgesten.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile msinkaut.h
Bibliothek InkObj.dll

Weitere Informationen

Gestenereignis

IInkOverlay

InkApplicationGesture-Enumeration

InkOverlay-Klasse

SetGestureStatus-Methode