Freigeben über

InkEdit-Nachrichten (nur Win32)

  • Artikel

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

Rufen Sie zum Senden dieser Nachrichten 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 Steuerelement 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
);
Abrufen/Festlegen einer Nachricht Beschreibung
EM_GETINKMODE
 Ruft den Freihandmodus des InkEdit--Steuerelements ab.
Parameter:
Diese Nachricht hat keine Parameter; wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt einen der Werte zurück, die in der InkMode--Aufzählung definiert sind, die angibt, ob die Freihandauflistung deaktiviert ist, ob Freihandeingaben erfasst werden oder ob Freihand- und Gesten erfasst werden.
EM_SETINKMODE
 Legt den Freihandmodus des InkEdit--Steuerelements fest.
Parameter:
wParam-Gibt einen der Werte der InkMode--Aufzählung an, die angibt, ob die Freihandauflistung deaktiviert ist, ob Freihandeingaben erfasst werden oder ob Freihand- und Gesten gesammelt werden.
lParamDieser Parameter wird nicht verwendet; es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Bemerkungen:
Dies sollte nur verwendet werden, wenn der EM_GETSTATUS IES_Idle zurückgibt.
EM_GETINKINSERTMODE
 Ruft den Freihandeinfügemodus des InkEdit-Steuerelements ab.
Parameter:
Diese Nachricht hat keine Parameter; wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt einen der Werte der InkInsertMode- Aufzählung zurück, die angibt, ob Freihand in das Steuerelement als Text oder als Freihand eingefügt wird.
EM_SETINKINSERTMODE
 Legt den Freihandeinfügemodus 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--Aufzählung an, die angibt, ob Freihand in das Steuerelement als Text oder als Freihand eingefügt wird.
lParamDieser 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:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParamGibt einen Zeiger (IInkDrawingAttributes **pDrawAttr) an, um das aktuelle InkDrawingAttributes-Objekt zu empfangen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETDRAWATTR
 Legt die Zeichenattribute fest, die für zukünftige Freihandauflistung verwendet werden sollen.
Parameter:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParamGibt 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 hat keine Parameter; wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Nachricht 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.
lParamDieser Parameter wird nicht verwendet; es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_GETGESTURESTATUS
 Ruft den Gestikstatus für das InkEdit--Steuerelement ab.
Parameter:
wParam-Gibt den Typ der Geste an, wie in der InkApplicationGesture Enumeration definiert.
lParamDieser 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 den Gestikstatus 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 die Überwachung der Geste nicht aktiviert ist.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Bemerkungen:
Dies sollte nur verwendet werden, wenn der EM_GETSTATUS IES_Idle zurückgibt.
EM_GETRECOGNIZER
 Ruft die Erkennung ab, die das InkEdit Steuerelement verwendet.
Parameter:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParamGibt 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 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:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParam-Gibt einen Zeiger auf einen IInkRecognizer* an, um das IInkRecognizer-Objekt festzulegen, das vom InkEdit Steuerelement für die spätere Verwendung verwendet wird.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Bemerkungen:
Dies sollte nur verwendet werden, wenn der EM_GETSTATUS IES_Idle zurückgibt.
EM_GETFACTOID
 Ruft die Factoid- ab, die für die Erkennung verwendet werden soll.
Parameter:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParam-Gibt einen Zeiger auf einen BSTR an, um die Factoid-Zeichenfolge zu empfangen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETFACTOID
 Legt den Factoid- fest, der für die Erkennung verwendet werden soll.
Parameter:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParamGibt den BSTR an, der die Factoid-Zeichenfolge enthält.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Bemerkungen:
Dies sollte nur verwendet werden, wenn der EM_GETSTATUS IES_Idle zurückgibt.
EM_GETSELINK
 Ruft die Freihandeingabe innerhalb der Auswahl ab. Freihandeingabe muss erkannt werden, bevor über diese Nachricht zugegriffen wird. Wenn sie nicht zuerst erkannt wird, gibt EM_GETSELINK immer null InkDisp- -Objekte zurück.
Parameter:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParam-Gibt einen Zeiger auf einen VARIANT-Wert an, der ein sicheres Array empfängt, um InkDisp Objekte innerhalb der aktuellen Auswahl zu empfangen.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
EM_SETSELINK
 Legt die Freihandeingabe innerhalb 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:
wParamDieser 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 hat 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, die 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--Aufzählung fest.
Parameter:
wParamDieser 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 den Status des InkEdit -Steuerelements ab.
Parameter:
Diese Nachricht hat keine Parameter; wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt einen der Werte der InkEditStatus- Aufzählung zurück, die angibt, ob das Steuerelement im Leerlauf ist, Freihandeingaben sammelt oder Freihand erkennt.
EM_RECOGNIZE
 Erzwingt die Erkennung.
Parameter:
Diese Nachricht hat 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:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParamGibt einen HICON*-Zeiger an, der mit dem aktuellen MouseIcon HICON gefüllt ist. Dieses 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 über den HICON-Handle verfügt. Wenn das InkEdit-Steuerelement das HICON besitzt, übernimmt es das HICON und zerstört es entsprechend. Andernfalls besitzt der Aufrufer das 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 ein Fehler auftritt.
EM_GETMOUSEPOINTER
 Ruft den Mauszeiger ab.
Parameter:
wParamDieser Parameter wird nicht verwendet; es 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 ein Fehler auftritt.
EM_SETMOUSEPOINTER
 Legt den Mauszeiger fest.
Parameter:
wParamDieser Parameter wird nicht verwendet; es muss 0 sein.
lParamEnthä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 Zustand ab, in dem die Mauseingabe als Stifteingabe behandelt wird.
Parameter:
Diese Nachricht hat keine Parameter; wParam und lParam müssen 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn FALSE- oder 1, wenn TRUE.
EM_SETUSEMOUSEFORINPUT
 Legt den Zustand fest, in dem die Mauseingabe als Stifteingabe behandelt wird.
Parameter:
wParam-Gibt einen booleschen Wert an, der bestimmt, ob Mauseingaben als Stifteingabe behandelt werden sollen.
lParamDieser Parameter wird nicht verwendet; es muss 0 sein.
Rückgabewerte:
Diese Meldung gibt 0 zurück, wenn ein Fehler auftritt.
Bemerkungen:
Dies sollte nur verwendet werden, wenn der 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 stattgefunden hat. 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 die Nachricht verarbeitet wird.

Gilt für

IEC_GESTUREINFO Struktur (nur Win32)

IEC_STROKEINFO Struktur (nur Win32)

IEC_RECOGNITIONRESULTINFO Struktur (nur Win32)

MousePointer-Eigenschaft

InkEditStatus-Aufzählung

InkInsertMode-Aufzählung

InkMode-Aufzählung

IInkCursor Interface

InkDrawingAttributes-Klasse

IInkRecognitionResult Interface

IInkRecognizer Interface

InkDisp-Klasse

IInkGesture Interface