FreihandNachrichten bearbeiten (nur Win32)

  • Artikel

Das InkEdit-Steuerelement ist eine Superklasse des RichEdit-Steuerelements . Jede RichEdit-Nachricht wird in den meisten Fällen direkt übergeben und hat genau die gleiche Wirkung wie in RichEdit. Dies gilt auch für Ereignisbenachrichtigungen.

Um diese Nachrichten zu senden, rufen Sie die SendMessage-Funktion mit den folgenden Parametern auf:

C++ 
LRESULT SendMessage(  HWND hWnd,      // handle to destination window  UINT Msg,       // message  WPARAM wParam,  // first message parameter  LPARAM lParam   // second message parameter);

Nachricht

Das übergeordnete Fenster des InkEdit-Steuerelements empfängt Ereignisbenachrichtigungen über die WM_NOTIFY Nachricht:

LRESULT CALLBACK WindowProc(
    HWND hWnd,                // handle to window
    UINT uMsg,                // WM_NOTIFY
    WPARAM wParam,        // InkEdit control identifier
    LPARAM lParam            // see documentation for notification messages
);
Nachricht abrufen/festlegen BESCHREIBUNG
EM_GETINKMODE
 Ruft den Freihandmodus des InkEdit-Steuerelements ab.
Parameter:
Diese Nachricht enthält keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Nachricht gibt einen der Werte zurück, die in der InkMode-Enumeration definiert sind, der angibt, ob die Freihandauflistung deaktiviert ist, ob Freihandeingaben erfasst werden oder ob Freihandeingaben und Gesten gesammelt werden.
EM_SETINKMODE
 Legt den Freihandmodus des InkEdit-Steuerelements fest.
Parameter:
Wparam Gibt einen der Werte der InkMode-Enumeration an, der angibt, ob die Freihandauflistung deaktiviert ist, ob Freihandeingaben erfasst werden oder ob Freihandeingaben und Gesten gesammelt werden.
Lparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn die EM_GETSTATUS IES_Idle zurückgibt.
EM_GETINKINSERTMODE
 Ruft den Freihandeinfügungsmodus des InkEdit-Steuerelements ab.
Parameter:
Diese Nachricht enthält keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt einen der Werte der InkInsertMode-Enumeration zurück, der angibt, ob Freihand als Text oder als Freihand in das Steuerelement eingefügt wird.
EM_SETINKINSERTMODE
 Legt den Freihandeinfügungsmodus des InkEdit-Steuerelements fest. Das Senden dieser Nachricht hat keine Auswirkung, wenn sie mit einem anderen Betriebssystem als Microsoft Windows XP Tablet PC Edition verwendet wird.
Parameter:
Wparam Gibt einen der Werte der InkInsertMode-Enumeration an, der angibt, ob Freihand als Text oder als Freihand in das Steuerelement eingefügt wird.
Lparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETDRAWATTR
 Ruft die aktuellen Zeichnungsattribute des InkEdit-Steuerelements ab.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen Zeiger (IInkDrawingAttributes **pDrawAttr) an, der das aktuelle InkDrawingAttributes-Objekt empfangen soll.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETDRAWATTR
 Legt die Zeichnungsattribute fest, die für eine zukünftige Freihandauflistung verwendet werden sollen.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen Zeiger (IInkDrawingAttributes *pDrawAttr) auf ein InkDrawingAttributes-Objekt an.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETRECOTIMEOUT
 Ruft das Erkennungstimeout in Millisekunden für das InkEdit-Steuerelement ab.
Parameter:
Diese Nachricht enthält keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt das Erkennungstimeout in Millisekunden zurück.
EM_SETRECOTIMEOUT
 Legt das Erkennungstimeout in Millisekunden für das InkEdit-Steuerelement fest.
Parameter:
Wparam Gibt das Erkennungstimeout in Millisekunden an.
Lparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETGESTURESTATUS
 Ruft die Geste status für das InkEdit-Steuerelement ab.
Parameter:
Wparam Gibt den Typ der Geste an, wie in der InkApplicationGesture-Enumeration definiert.
Lparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt TRUE zurück, wenn das InkEdit-Steuerelement die Geste abonniert, oder FALSE , wenn das InkEdit-Steuerelement die Geste nicht abonniert.
EM_SETGESTURESTATUS
 Legt die Geste status für das InkEdit-Steuerelement fest.
Parameter:
Wparam Gibt den Typ der Geste an, wie in der InkApplicationGesture-Enumeration definiert.
Lparam Gibt TRUE an, wenn das Abonnieren der Geste aktiviert ist, oder FALSE , wenn das Lauschen auf die Geste nicht aktiviert ist.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn die EM_GETSTATUS IES_Idle zurückgibt.
EM_GETRECOGNIZER
 Ruft die Erkennung ab, die vom InkEdit-Steuerelement verwendet wird.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen Zeiger auf einen IInkRecognizer* an, um das IInkRecognizer-Objekt zu empfangen, das das InkEdit-Steuerelement verwendet.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETRECOGNIZER
 Legt die Erkennung fest, die vom InkEdit-Steuerelement verwendet wird. Wenn ein Factoid für das InkEdit-Steuerelement verwendet wird, muss es nach dem Senden dieser Nachricht erneut angewendet werden.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen Zeiger auf einen IInkRecognizer* an, um das IInkRecognizer-Objekt festzulegen, das das InkEdit-Steuerelement für die spätere Verwendung verwendet.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn die EM_GETSTATUS IES_Idle zurückgibt.
EM_GETFACTOID
 Ruft das Factoid ab, das für die Erkennung verwendet werden soll.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen Zeiger auf einen BSTR an, der die factoid-Zeichenfolge empfangen soll.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETFACTOID
 Legt das Factoid fest, das für die Erkennung verwendet werden soll.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt den BSTR an, der die factoid-Zeichenfolge enthält.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn die EM_GETSTATUS IES_Idle zurückgibt.
EM_GETSELINK
 Ruft die Freihandeingabe innerhalb der Auswahl ab. Die Freihandeingabe muss erkannt werden, bevor über diese Nachricht darauf zugegriffen wird. Wenn es zuerst nicht erkannt wird, gibt EM_GETSELINK immer null InkDisp-Objekte zurück.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen Zeiger auf einen VARIANT an, der ein sicheres Array zum Empfangen von InkDisp-Objekten innerhalb der aktuellen Auswahl empfängt.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETSELINK
 Legt die Freihandeingabe in der Auswahl fest. Das Senden dieser Nachricht hat keine Auswirkung, wenn sie mit einem anderen Betriebssystem als Windows XP Tablet PC Edition verwendet wird.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen Zeiger auf einen VARIANT-Wert mit einem sicheren Array von InkDisp-Objekten an, um die aktuelle Auswahl zu ersetzen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETSELINKDISPLAYMODE
 Gibt die aktuelle Darstellung der Freihandeingabe im ausgewählten Bereich mithilfe eines der Werte der InkDisplayMode-Enumeration zurück.
Parameter:
Diese Nachricht enthält keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt einen der Werte der InkDisplayMode-Enumeration (IDM_Text oder IDM_Ink) zurück, der angibt, wie eine Auswahl im Steuerelement angezeigt wird.
EM_SETSELINKDISPLAYMODE
 Legt die Darstellung der Freihandeingabe im ausgewählten Bereich mithilfe eines der Werte der InkDisplayMode-Enumeration fest.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt an, wie freihand im ausgewählten Bereich angezeigt wird, wie in der InkDisplayMode-Enumeration definiert.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt. Das Senden dieser Nachricht hat keine Auswirkung, wenn sie mit einem anderen Betriebssystem als Windows XP Tablet PC Edition verwendet wird.
EM_GETSTATUS
 Ruft die status des InkEdit-Steuerelements ab.
Parameter:
Diese Nachricht enthält keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Nachricht gibt einen der Werte der InkEditStatus-Enumeration zurück, der angibt, ob sich das Steuerelement im Leerlauf befindet, Freihandeingaben sammelt oder Freihand erkennt.
EM_RECOGNIZE
 Erzwingt die Erkennung.
Parameter:
Diese Nachricht enthält keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETMOUSEICON
 Ruft das Maussymbol ab.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Gibt einen HICON*-Zeiger an, der mit dem aktuellen MouseIcon HICON ausgefüllt wird. Dieser HICON kann entweder ein HICON- oder ein NULL-Wert sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETMOUSEICON
 Legt das Maussymbol fest.
Parameter:
Wparam Gibt einen BOOLESCHEN Wert an, der auf TRUE festgelegt ist, wenn das InkEdit-Steuerelement das HICON-Handle besitzen soll, oder FALSE , wenn das InkEdit-Steuerelement nicht der Besitzer des HICON-Handles sein soll. Wenn das InkEdit-Steuerelement das HICON besitzt, kümmert es sich um die HICON und zerstört es entsprechend. Andernfalls besitzt der Aufrufer das HICON und ist für dessen Löschen verantwortlich.
Lparam Gibt den neuen HICON-Wert an. Verwenden Sie NULL , um den Wert zu löschen. Der Standardwert ist NULL.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETMOUSEPOINTER
 Ruft den Mauszeiger ab.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Enthält einen InkMousePointer*-Zeiger, der mit dem aktuellen MousePointer-Wert ausgefüllt ist. Dies verhält sich genauso wie die InkCollector::get_MousePointer-Eigenschaft .
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETMOUSEPOINTER
 Legt den Mauszeiger fest.
Parameter:
Wparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Lparam Enthält den neuen MousePointer-Wert , der in der InkMousePointer-Enumeration definiert ist. Dies verhält sich genauso wie die InkCollector::p ut_MousePointer-Eigenschaft .
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETUSEMOUSEFORINPUT
 Ruft den Status ab, in dem die Mauseingabe als Stifteingabe behandelt wird.
Parameter:
Diese Nachricht enthält keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn FALSE oder 1 bei TRUE.
EM_SETUSEMOUSEFORINPUT
 Legt den Status fest, ob Mauseingaben als Stifteingabe behandelt werden.
Parameter:
Wparam Gibt einen booleschen Wert an, der bestimmt, ob Mauseingaben als Stifteingabe behandelt werden sollen.
Lparam Dieser Parameter wird nicht verwendet. es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn die EM_GETSTATUS IES_Idle zurückgibt.
Ereignisbenachrichtigung BESCHREIBUNG
IECN_STROKE
 Benachrichtigt das übergeordnete Fenster des InkEdit-Steuerelements , dass ein IInkStrokeDisp erstellt wurde. Dies wird in einer WM_NOTIFY Nachricht mit den folgenden Parametern gesendet.
Parameter:
Wparam Gibt den Bezeichner des Steuerelements an, das die Nachricht gesendet hat.
Lparam Gibt einen Zeiger auf die IEC_STROKEINFO-Struktur an.
Rückgabewerte:
Der Client gibt 0 zurück, um den Strich zu akzeptieren, und 1, um den Strich abzubrechen.
IECN_GESTURE
 Benachrichtigt das übergeordnete Fenster des InkEdit-Steuerelements , dass eine Geste erkannt wurde. Dies wird in einer WM_NOTIFY Nachricht mit den folgenden Parametern gesendet.
Parameter:
Wparam Gibt den Bezeichner des Steuerelements an, das die Nachricht gesendet hat.
Lparam Gibt einen Zeiger auf die IEC_GESTUREINFO-Struktur an.
Rückgabewerte:
Der Client gibt 0 zurück, um die Geste zu akzeptieren, und 1, um die Geste abzubrechen.
IECN_RECOGNITIONRESULT
 Benachrichtigt das übergeordnete Fenster des InkEdit-Steuerelements , dass die Erkennung erfolgt ist. Dies wird in einer WM_NOTIFY Nachricht mit den folgenden Parametern gesendet.
Parameter:
Wparam Gibt den Bezeichner des Steuerelements an, das die Nachricht gesendet hat.
Lparam Gibt einen Zeiger auf die IEC_RECOGNITIONRESULTINFO-Struktur an.
Rückgabewerte:
Der Client gibt 0 zurück, wenn er die Nachricht verarbeitet.

Gilt für

IEC_GESTUREINFO-Struktur (nur Win32)

IEC_STROKEINFO-Struktur (nur Win32)

IEC_RECOGNITIONRESULTINFO-Struktur (nur Win32)

MousePointer-Eigenschaft

InkEditStatus-Enumeration

InkInsertMode-Enumeration

InkMode-Enumeration

IInkCursor-Schnittstelle

InkDrawingAttributes-Klasse

IInkRecognitionResult-Schnittstelle

IInkRecognizer-Schnittstelle

InkDisp-Klasse

IInkGesture-Schnittstelle