InkEdit Messages (Nur Win32)

Das InkEdit-Steuerelement ist eine Oberklasse 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 Ereignisbenachrichtigungsmeldungen.

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);

Message

Das übergeordnete Fenster des InkEdit-Steuerelements empfängt Ereignisbenachrichtigungsmeldungen über die WM _ NOTIFY-Meldung:

LRESULT CALLBACK WindowProc(
    HWND hWnd,                // handle to window
    UINT uMsg,                // WM_NOTIFY
    WPARAM wParam,        // InkEdit control identifier
    LPARAM lParam            // see documentation for notification messages
);
Get/set message BESCHREIBUNG
EM _ GETINKMODE
Ruft den Inking-Modus des InkEdit-Steuerelements ab.
Parameter:
Diese Meldung verfügt über keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt einen der Werte zurück, die in der InkMode-Enumeration definiert sind, der angibt, ob die Ink-Sammlung deaktiviert ist, ob Ink gesammelt wird oder ob Ink und Gesten gesammelt werden.
EM _ SETINKMODE
Legt den Inking-Modus des InkEdit-Steuerelements fest.
Parameter:
wParam Gibt einen der Werte der InkMode-Enumeration an, der angibt, ob die Ink-Auflistung deaktiviert ist, ob Ink gesammelt wird oder ob Ink- und Gesten gesammelt werden.
lParam Dieser Parameter wird nicht verwendet. muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn EM _ GETSTATUS IES _ Idle zurückgibt.
EM _ GETINKINSERTMODE
Ruft den InkEdit-Einfügemodus des InkEdit-Steuerelements ab.
Parameter:
Diese Meldung verfügt über 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 Ink als Text oder als Ink in das Steuerelement eingefügt wird.
EM _ SETINKINSERTMODE
Legt den Ink-Einfügemodus des InkEdit-Steuerelements fest. Das Senden dieser Meldung hat keine Auswirkungen, wenn es 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 Ink als Text oder als Ink in das Steuerelement eingefügt wird.
lParam Dieser Parameter wird nicht verwendet. muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ GETDRAWATTR
Ruft die aktuellen Zeichnungsattribute des InkEdit-Steuerelements ab.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Gibt einen Zeiger (IInkDrawingAttributes * * pDrawAttr) an, um das aktuelle InkDrawingAttributes-Objekt zu empfangen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ SETDRAWATTR
Legt die Zeichnungsattribute fest, die für zukünftige Ink-Auflistungen verwendet werden sollen.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Gibt einen Zeiger (IInkDrawingAttributes * pDrawAttr) auf ein InkDrawingAttributes-Objekt an.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ GETRECOTIMEOUT
Ruft das Erkennungs-Timeout für das InkEdit-Steuerelement in Millisekunden ab.
Parameter:
Diese Meldung verfügt über keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt das Erkennungs-Timeout in Millisekunden zurück.
EM _ SETRECOTIMEOUT
Legt das Erkennungs-Timeout für das InkEdit-Steuerelement in Millisekunden fest.
Parameter:
wParam Gibt das Erkennungs-Timeout in Millisekunden an.
lParam Dieser Parameter wird nicht verwendet. muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ GETGESTURESTATUS
Ruft den Gestenstatus 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. 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 den Gestenstatus 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 erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn EM _ GETSTATUS IES _ Idle zurückgibt.
EM _ GETRECOGNIZER
Ruft die Vom InkEdit-Steuerelement verwendete Erkennt ab.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Gibt einen Zeiger auf einen IInkRecognizer an, um das * IInkRecognizer-Objekt zu empfangen, das vom InkEdit-Steuerelement verwendet wird.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ SETRECOGNIZER
Legt die Vom InkEdit-Steuerelement verwendete Erkennt fest. 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. muss 0 sein.
lParam Gibt einen Zeiger auf einen IInkRecognizer an, um das * IInkRecognizer-Objekt, das vom InkEdit-Steuerelement zur späteren Verwendung verwendet wird, zu setzen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn 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. muss 0 sein.
lParam Gibt einen Zeiger auf einen BSTR an, um die Faktenzeichenfolge zu empfangen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), 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. muss 0 sein.
lParam Gibt den BSTR an, der die Faktenzeichenfolge enthält.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
Anmerkungen:
Dies sollte nur verwendet werden, wenn EM _ GETSTATUS IES _ Idle zurückgibt.
EM _ GETSELINK
Ruft die Ink-Datei innerhalb der Auswahl ab. Ink muss erkannt werden, bevor über diese Nachricht auf zugegriffen wird. Wenn er nicht zuerst erkannt wird, gibt EM _ GETSELINK immer null InkDisp-Objekte zurück.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Gibt einen Zeiger auf eine VARIANT an, um ein sicheres Array zum Empfangen von InkDisp-Objekten innerhalb der aktuellen Auswahl zu empfangen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ SETSELINK
Legt die Ink-Datei innerhalb der Auswahl fest. Das Senden dieser Meldung hat keine Auswirkungen, wenn es mit einem anderen Betriebssystem als xp Windows XP Tablet PC Edition verwendet wird.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Gibt einen Zeiger auf eine VARIANT-Datei mit einem sicheren Array von InkDisp-Objekten an, um die aktuelle Auswahl zu ersetzen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ GETSELINKDISPLAYMODE
Gibt die aktuelle Darstellung der Ink-Funktion im ausgewählten Bereich zurück, indem einer der Werte der InkDisplayMode-Enumeration verwendet wird.
Parameter:
Diese Meldung verfügt über 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 auf dem _ Steuerelement angezeigt wird.
EM _ SETSELINKDISPLAYMODE
Legt die Darstellung der InkDisplayMode-Enumeration im ausgewählten Bereich mithilfe eines der Werte der InkDisplayMode-Enumeration fest.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Gibt an, wie Ink Im ausgewählten Bereich angezeigt wird, wie in der InkDisplayMode-Enumeration definiert.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt. Das Senden dieser Meldung hat keine Auswirkungen, wenn es mit einem anderen Betriebssystem als xp Windows XP Tablet PC Edition verwendet wird.
EM _ GETSTATUS
Ruft den Status des InkEdit-Steuerelements ab.
Parameter:
Diese Meldung verfügt über keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt einen der Werte der InkEditStatus-Enumeration zurück, der angibt, ob sich das Steuerelement im Leerlauf befindet, Ink sammelt oder Ink erkennt.
EM _ RECOGNIZE
Erzwingt die Erkennung.
Parameter:
Diese Meldung verfügt über keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ GETMOUSEICON
Ruft das Maussymbol ab.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Gibt einen HICON-Zeiger an, der mit dem aktuellen * MouseIcon HICON aufgefüllt wird. Diese HICON kann entweder ein HICON- oder ein NULL-Wert sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), 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 das HICON-Handle besitzen soll. Wenn das InkEdit-Steuerelement den HICON besitzt, übernimmt es das HICON und zerstört es entsprechend. Andernfalls besitzt der Aufrufer den HICON und ist für das 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 erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ GETMOUSEPOINTER
Ruft den Mauszeiger ab.
Parameter:
wParam Dieser Parameter wird nicht verwendet. muss 0 sein.
lParam Enthält einen InkMousePointer-Zeiger, der mit dem * aktuellen MousePointer-Wert gefüllt ist. Dies verhält sich genauso wie die InkCollector::get _ MousePointer-Eigenschaft.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ SETMOUSEPOINTER
Legt den Mauszeiger fest.
Parameter:
wParam Dieser Parameter wird nicht verwendet. 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 erfolgreich oder ungleich 0 (null), wenn ein Fehler auftritt.
EM _ GETUSEMOUSEFORINPUT
Ruft den Status ab, ob Mauseingaben als Stifteingabe behandelt werden.
Parameter:
Diese Meldung verfügt über keine Parameter. wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 bei FALSE oder 1 bei TRUE zurück.
EM _ SETUSEMOUSEFORINPUT
Legt den Zustand fest, ob die Mauseingabe als Stifteingabe behandelt wird.
Parameter:
wParam Gibt einen booleschen Wert an, der bestimmt, ob Mauseingaben als Stifteingabe behandelt werden sollen.
lParam Dieser Parameter wird nicht verwendet. muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 (null) zurück, wenn der Fehler erfolgreich ist, oder bei einem Fehler ungleich 0 (null).
Anmerkungen:
Dies sollte nur verwendet werden, wenn DER EM _ GETSTATUS IES _ Idle zurückgibt.
Ereignisbenachrichtigungsmeldung 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-GESTE
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 eine Erkennung aufgetreten 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