Sdílet prostřednictvím

Zprávy InkEdit (pouze Win32)

  • Článek

Ovládací prvek InkEdit je super třída ovládacího prvku RichEdit. Každá RichEdit zpráva je předána přímo ve většině případů a má přesně stejný účinek jako v RichEdit. To platí také pro zprávy s oznámením událostí.

Chcete-li odeslat tyto zprávy, zavolejte funkci SendMessage s následujícími parametry:

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

Zpráva

Nadřazené okno ovládacího prvku InkEdit přijímá zprávy s oznámením o událostech prostřednictvím zprávy WM_NOTIFY:

LRESULT CALLBACK WindowProc(
    HWND hWnd,                // handle to window
    UINT uMsg,                // WM_NOTIFY
    WPARAM wParam,        // InkEdit control identifier
    LPARAM lParam            // see documentation for notification messages
);
Získání nebo nastavení zprávy Popis
EM_GETINKMODE
 Získá režim rukopisu InkEdit ovládací prvek.
Parametry:
Tato zpráva nemá žádné parametry; wParam a lPara m musí být 0.
Návratové hodnoty:
Tato zpráva vrátí jednu z hodnot definovaných v InkMode výčtu, která určuje, jestli je kolekce rukopisu zakázaná, jestli se shromažďuje rukopis nebo jestli se shromažďují rukopis a gesta.
EM_SETINKMODE
 Nastaví režim rukopisu ovládacího prvku InkEdit.
Parametry:
wParamUrčuje jednu z hodnot InkMode výčtu, která určuje, jestli je kolekce rukopisu zakázaná, jestli se shromažďuje rukopis nebo jestli se shromažďují rukopis a gesta.
lParamTento parametr se nepoužívá; musí být 0.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
Poznámky:
Tato možnost by se měla použít pouze v případě, že EM_GETSTATUS vrátí IES_Idle.
EM_GETINKINSERTMODE
 Získá režim vložení rukopisu InkEdit ovládací prvek.
Parametry:
Tato zpráva nemá žádné parametry; wParam a lPara m musí být 0.
Návratové hodnoty:
Tato zpráva vrátí jednu z hodnot InkInsertMode výčtu, která určuje, zda je rukopis vložen do ovládacího prvku jako text nebo jako rukopis.
EM_SETINKINSERTMODE
 Nastaví režim vkládání rukopisu ovládacího prvku InkEdit. Odeslání této zprávy nemá žádný vliv, pokud se používá s jiným operačním systémem než Microsoft Windows XP Tablet PC Edition.
Parametry:
wParamUrčuje jednu z hodnot InkInsertMode výčtu, která určuje, zda je rukopis vložen do ovládacího prvku jako text nebo jako rukopis.
lParamTento parametr se nepoužívá; musí být 0.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_GETDRAWATTR
 Získá aktuální atributy výkresu InkEdit ovládacího prvku.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel (IInkDrawingAttributes **pDrawAttr) pro příjem aktuální InkDrawingAttributes objektu.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_SETDRAWATTR
 Nastaví atributy výkresu tak, aby se používaly pro budoucí kolekci rukopisu.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel (IInkDrawingAttributes *pDrawAttr) na objekt InkDrawingAttributes objektu.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_GETRECOTIMEOUT
 Získá časový limit rozpoznávání v milisekundách pro InkEdit ovládací prvek.
Parametry:
Tato zpráva nemá žádné parametry; wParam a lPara m musí být 0.
Návratové hodnoty:
Tato zpráva vrátí časový limit rozpoznávání v milisekundách.
EM_SETRECOTIMEOUT
 Nastaví časový limit rozpoznávání v milisekundách pro ovládací prvek InkEdit.
Parametry:
wParamUrčuje časový limit rozpoznávání v milisekundách.
lParamTento parametr se nepoužívá; musí být 0.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_GETGESTURESTATUS
 Získá stav gesta pro ovládací prvek InkEdit.
Parametry:
wParamUrčuje typ gesta, jak je definováno v InkApplicationGesture výčtu.
lParamTento parametr se nepoužívá; musí být 0.
Návratové hodnoty:
Tato zpráva vrátí TRUE, pokud se ovládací prvek InkEdit přihlásí k odběru gesta nebo FALSE, pokud se ovládací prvek InkEdit nepřihlásí k odběru gesta.
EM_SETGESTURESTATUS
 Nastaví stav gesta pro ovládací prvek InkEdit.
Parametry:
wParamUrčuje typ gesta, jak je definováno v InkApplicationGesture výčtu.
lParamUrčuje TRUE, pokud je povolené přihlášení k odběru gesta nebo FALSE, pokud není povoleno naslouchání gestu.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
Poznámky:
Tato možnost by se měla použít pouze v případě, že EM_GETSTATUS vrátí IES_Idle.
EM_GETRECOGNIZER
 Získá rozpoznávání, že InkEdit ovládací prvek používá.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel na IInkRecognizer* pro příjem IInkRecognizer objekt, který InkEdit ovládací prvek používá.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_SETRECOGNIZER
 Nastaví rozpoznávání, který používá ovládací prvek InkEdit. Pokud se pro ovládací prvek InkEdit používá Factoid, musí se po odeslání této zprávy znovu použít.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel na IInkRecognizer* nastavit IInkRecognizer objekt, který InkEdit ovládací prvek používá pro pozdější použití.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
Poznámky:
Tato možnost by se měla použít pouze v případě, že EM_GETSTATUS vrátí IES_Idle.
EM_GETFACTOID
 Získá Factoid použít k rozpoznávání.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel na BSTR pro příjem řetězce factoid.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_SETFACTOID
 Nastaví factoid použít k rozpoznávání.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje BSTR obsahující řetězec factoid.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
Poznámky:
Tato možnost by se měla použít pouze v případě, že EM_GETSTATUS vrátí IES_Idle.
EM_GETSELINK
 Získá rukopis v rámci výběru. Před přístupem k této zprávě je nutné rozpoznat rukopis. Pokud není rozpoznán jako první, EM_GETSELINK vždy vrátí nula InkDisp objekty.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel na variantu pro příjem bezpečného pole pro příjem objektů InkDisp v rámci aktuálního výběru.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_SETSELINK
 Nastaví rukopis v rámci výběru. Odeslání této zprávy nemá žádný vliv, pokud se používá s jiným operačním systémem než Windows XP Tablet PC Edition.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel na VARIANT s bezpečným polem InkDisp objekty nahradit aktuální výběr.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_GETSELINKDISPLAYMODE
 Vrátí aktuální vzhled rukopisu ve vybrané oblasti pomocí jedné z hodnot InkDisplayMode výčtu.
Parametry:
Tato zpráva nemá žádné parametry; wParam a lPara m musí být 0.
Návratové hodnoty:
Tato zpráva vrátí jednu z hodnot InkDisplayMode výčtu (IDM_Text nebo IDM_Ink), která určuje, jak se v ovládacím prvku zobrazuje výběr.
EM_SETSELINKDISPLAYMODE
 Nastaví vzhled rukopisu ve vybrané oblasti pomocí jedné z hodnot InkDisplayMode výčtu.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje, jak se rukopis zobrazí ve vybrané oblasti, jak je definováno v InkDisplayMode výčtu.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové. Odeslání této zprávy nemá žádný vliv, pokud se používá s jiným operačním systémem než Windows XP Tablet PC Edition.
EM_GETSTATUS
 Získá stav InkEdit ovládací prvek.
Parametry:
Tato zpráva nemá žádné parametry; wParam a lPara m musí být 0.
Návratové hodnoty:
Tato zpráva vrátí jednu z hodnot InkEditStatus výčtu, která určuje, jestli je ovládací prvek nečinný, shromažďuje rukopis nebo rozpoznává rukopis.
EM_RECOGNIZE
 Vynutí rozpoznávání.
Parametry:
Tato zpráva nemá žádné parametry; wParam a lPara m musí být 0.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_GETMOUSEICON
 Získá ikonu myši.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamUrčuje ukazatel HICON*, který je vyplněn aktuálním MouseIcon HICON. Tento HICON může být buď HICON, nebo hodnota NULL.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_SETMOUSEICON
 Nastaví ikonu myši.
Parametry:
wParamUrčuje hodnotu BOOLEAN, která je nastavena na TRUE, pokud by ovládací prvek InkEdit měl vlastnit popisovač HICON nebo FALSE, pokud by ovládací prvek InkEdit neměl vlastnit popisovač HICON. Pokud ovládací prvek InkEdit vlastní HICON, postará se o hiCON a odpovídajícím způsobem zničí HICON. Jinak volající vlastní HICON a zodpovídá za jeho odstranění.
lParamUrčuje novou hodnotu HICON. K vymazání hodnoty použijte NULL. Výchozí hodnota je null.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_GETMOUSEPOINTER
 Získá ukazatel myši.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamObsahuje ukazatel InkMousePointer*, který je vyplněn aktuální hodnotou MousePointer. Chová se stejně jako vlastnost InkCollector::get_MousePointer.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_SETMOUSEPOINTER
 Nastaví ukazatel myši.
Parametry:
wParamTento parametr se nepoužívá; musí být 0.
lParamObsahuje novou hodnotuMousePointer, která je definována vvýčtuInkMousePointer. Chová se stejně jako vlastnost InkCollector::p ut_MousePointer.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
EM_GETUSEMOUSEFORINPUT
 Získá stav, zda vstup myši je považován za vstup pera.
Parametry:
Tato zpráva nemá žádné parametry; wParam a lPara m musí být 0.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud FALSE nebo 1, pokud TRUE.
EM_SETUSEMOUSEFORINPUT
 Nastaví stav, zda je vstup myši považován za vstup pera.
Parametry:
wParamUrčuje logickou hodnotu, která určuje, zda má být vstup myši považován za vstup pera.
lParamTento parametr se nepoužívá; musí být 0.
Návratové hodnoty:
Tato zpráva vrátí hodnotu 0, pokud dojde k chybě nebo nenulové.
Poznámky:
Tato možnost by se měla použít pouze v případě, že EM_GETSTATUS vrátí IES_Idle.
Zpráva s oznámením události Popis
IECN_STROKE
 Upozorní nadřazené okno ovládacího prvku InkEdit, že byl vytvořen IInkStrokeDisp. Tato zpráva se odešle ve zprávě WM_NOTIFY s následujícími parametry.
Parametry:
wParamUrčuje identifikátor ovládacího prvku, který zprávu odeslal.
lParamUrčuje ukazatel na strukturu IEC_STROKEINFO.
Návratové hodnoty:
Klient vrátí hodnotu 0 pro přijetí tahu a 1 pro zrušení tahu.
IECN_GESTURE
 Upozorní nadřazené okno ovládacího prvku InkEdit, že bylo rozpoznáno gesto. Tato zpráva se odešle ve zprávě WM_NOTIFY s následujícími parametry.
Parametry:
wParamUrčuje identifikátor ovládacího prvku, který zprávu odeslal.
lParamUrčuje ukazatel na strukturu IEC_GESTUREINFO.
Návratové hodnoty:
Klient vrátí hodnotu 0 pro přijetí gesta a 1 pro zrušení gesta.
IECN_RECOGNITIONRESULT
 Upozorní nadřazené okno ovládacího prvku InkEdit, že došlo k rozpoznávání. Tato zpráva se odešle ve zprávě WM_NOTIFY s následujícími parametry.
Parametry:
wParamUrčuje identifikátor ovládacího prvku, který zprávu odeslal.
lParamUrčuje ukazatel na strukturu IEC_RECOGNITIONRESULTINFO.
Návratové hodnoty:
Klient vrátí hodnotu 0, pokud zpracuje zprávu.

Platí pro

  • InkEdit

strukturyIEC_GESTUREINFO (pouze Win32)

strukturyIEC_STROKEINFO (pouze Win32)

struktura IEC_RECOGNITIONRESULTINFO (pouze Win32)

vlastnosti mousepointeru

výčtu InkEditStatus

InkInsertMode – výčet

výčtu InkMode –

IInkCursor – rozhraní

třídy InkDrawingAttributes

IInkRecognitionResult – rozhraní

IInkRecognizer – rozhraní

třídyInkDisp

IInkGesture – rozhraní