Szabadkézi üzenetek (csak Win32 esetén)
A InkEdit vezérlő a RichEdit vezérlő szuperosztálya. Minden RichEdit üzenet közvetlenül a legtöbb esetben tovább lesz adva, és pontosan ugyanaz a hatása van, mint RichEdit. Ez az eseményértesítési üzenetekre is vonatkozik.
Az üzenetek küldéséhez hívja meg a SendMessage függvényt a következő paraméterekkel:
C++ |
---|
|
Üzenet
A InkEdit vezérlő szülőablaka eseményértesítési üzeneteket fogad a WM_NOTIFY üzeneten keresztül:
LRESULT CALLBACK WindowProc(
HWND hWnd, // handle to window
UINT uMsg, // WM_NOTIFY
WPARAM wParam, // InkEdit control identifier
LPARAM lParam // see documentation for notification messages
);
Üzenet lekérése/beállítása | Leírás |
---|---|
EM_GETINKMODE |
Lekéri a Szabadkézi elem vezérlőelem szabadkézi módját. Paraméterek: Ez az üzenet nem tartalmaz paramétereket; wParam és lParam 0-nak kell lennie. Visszaadott értékek: Ez az üzenet a InkMode enumerálásban definiált értékek egyikét adja vissza, amely meghatározza, hogy a szabadkézett gyűjtemény le van-e tiltva, hogy a szabadkézett elemeket gyűjtik-e, illetve hogy a szabadkézés és a kézmozdulatok vannak-e összegyűjtve. |
EM_SETINKMODE |
A Szabadkézi elem vezérlőelem szabadkézi üzemmódját állítja be. Paraméterek: wParamA InkMode enumerálás egyik értékét adja meg, amely meghatározza, hogy a szabadkézi gyűjtemény le van-e tiltva, a szabadkézi elemeket gyűjti-e, illetve hogy a szabadkézi elemek és a kézmozdulatok vannak-e összegyűjtve. lParamEz a paraméter nem használatos; 0-nak kell lennie. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. Megjegyzések: Ezt csak akkor szabad használni, ha a EM_GETSTATUS IES_Idle ad vissza. |
EM_GETINKINSERTMODE |
Lekéri az Szabadkézi elemszerkesztési vezérlőelem szabadkézi beszúrási módját. Paraméterek: Ez az üzenet nem tartalmaz paramétereket; wParam és lParam 0-nak kell lennie. Visszaadott értékek: Ez az üzenet a InkInsertMode enumerálás egyik értékét adja vissza, amely meghatározza, hogy a szabadkézés szövegként vagy szabadkézettként van-e beszúrva a vezérlőbe. |
EM_SETINKINSERTMODE |
A Szabadkézi elemszerkesztési vezérlőelem szabadkézi beszúrási módját állítja be. Az üzenet elküldésének nincs hatása, ha a Microsoft Windows XP Tablet PC Edition kiadástól eltérő operációs rendszerrel van telepítve. Paraméterek: wParamA InkInsertMode enumerálás egyik értékét adja meg, amely meghatározza, hogy a szabadkézi elemek szövegként vagy szabadkézi elemként lesznek-e beszúrva a vezérlőbe. lParamEz a paraméter nem használatos; 0-nak kell lennie. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_GETDRAWATTR |
Lekéri a InkEdit vezérlőelem aktuális rajzattribútumait. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamEgy mutatót (IInkDrawingAttributes **pDrawAttr) ad meg az aktuális InkDrawingAttributes objektum fogadásához. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_SETDRAWATTR |
Beállítja a jövőbeli szabadkézi gyűjteményhez használni kívánt rajzattribútumokat. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamEgy mutatót (IInkDrawingAttributes *pDrawAttr) ad meg egy InkDrawingAttributes objektumhoz. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_GETRECOTIMEOUT |
Ezredmásodpercben lekéri a felismerési időtúllépést a InkEdit vezérlőhöz. Paraméterek: Ez az üzenet nem tartalmaz paramétereket; wParam és lParam 0-nak kell lennie. Visszaadott értékek: Ez az üzenet a felismerési időtúllépést adja vissza ezredmásodpercben. |
EM_SETRECOTIMEOUT |
Ezredmásodpercben állítja be a felismerési időtúllépést a InkEdit vezérlőelemhez. Paraméterek: wParamEzredmásodpercben adja meg a felismerés időtúllépését. lParamEz a paraméter nem használatos; 0-nak kell lennie. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_GETGESTURESTATUS |
Lekéri a InkEdit vezérlőelem kézmozdulatának állapotát. Paraméterek: wParamA InkApplicationGesture enumerálásban meghatározott kézmozdulattípust adja meg. lParamEz a paraméter nem használatos; 0-nak kell lennie. Visszaadott értékek: Ez az üzenet IGAZ ad vissza, ha a Szabadkézi vezérlőelem előfizet a kézmozdulatra, vagy HAMIS, ha az InkEdit vezérlőelem nem iratkozott fel a kézmozdulatra. |
EM_SETGESTURESTATUS |
A InkEdit vezérlőelem kézmozdulati állapotát állítja be. Paraméterek: wParamA InkApplicationGesture enumerálásban meghatározott kézmozdulattípust adja meg. lParamMegadja IGAZ, ha engedélyezve van a kézmozdulatra való feliratkozás, vagy ha a kézmozdulat figyelése nincs engedélyezve, HAMIS. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. Megjegyzések: Ezt csak akkor szabad használni, ha a EM_GETSTATUS IES_Idle ad vissza. |
EM_GETRECOGNIZER |
Lekéri a InkEdit vezérlő által használt felismerőt. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamEgy IInkRecognizer* mutatóját adja meg a IInkRecognizer objektum fogadásához, amelyet a InkEdit vezérlő használ. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_SETRECOGNIZER |
Beállítja a InkEdit vezérlő által használt felismerőt. Ha egy Factoid használ az InkEdit vezérlőelemhez, az üzenet elküldése után újra kell alkalmazni. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamEgy IInkRecognizer*-ra mutató mutatót ad meg a IInkRecognizer objektum beállításához, amelyet a InkEdit vezérlő használ későbbi használatra. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. Megjegyzések: Ezt csak akkor szabad használni, ha a EM_GETSTATUS IES_Idle ad vissza. |
EM_GETFACTOID |
Lekéri a Factoid a felismeréshez. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamA factoid sztring fogadásához egy BSTR-hez mutató mutatót ad meg. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_SETFACTOID |
Beállítja a Factoid a felismeréshez. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamA factoid sztringet tartalmazó BSTR-t adja meg. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. Megjegyzések: Ezt csak akkor szabad használni, ha a EM_GETSTATUS IES_Idle ad vissza. |
EM_GETSELINK |
Lekéri a szabadkézi elemeket a kijelölésen belül. Az üzeneten keresztüli hozzáférés előtt fel kell ismerni a szabadkévet. Ha először nem ismeri fel, EM_GETSELINK mindig nulla InkDisp objektumot ad vissza. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamEgy VARIANT-ra mutató mutatót ad meg, amely biztonságos tömböt fogad InkDisp objektumok fogadásához az aktuális kijelölésen belül. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_SETSELINK |
Beállítja a szabadkézett elemeket a kijelölésen belül. Az üzenet elküldésének nincs hatása, ha a Windows XP Tablet PC Edition kiadástól eltérő operációs rendszerrel van telepítve. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamAz aktuális kijelölés helyére InkDisp objektumok biztonságos tömbjével rendelkező VARIANT-ra mutató mutatót ad meg. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_GETSELINKDISPLAYMODE |
A kijelölt tartományban lévő szabadkézés aktuális megjelenését adja vissza a InkDisplayMode enumerálás egyik értékével. Paraméterek: Ez az üzenet nem tartalmaz paramétereket; wParam és lParam 0-nak kell lennie. Visszaadott értékek: Ez az üzenet a InkDisplayMode enumerálás (IDM_Text vagy IDM_Ink) egyik értékét adja vissza, amely meghatározza, hogyan jelenik meg egy kijelölés a vezérlőelemen. |
EM_SETSELINKDISPLAYMODE |
A szabadkézés megjelenését a kijelölt tartományban a InkDisplayMode enumerálás egyik értékével állítja be. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamMeghatározza, hogy a szabadkézi elemek hogyan jelenjenek meg a kijelölt tartományban az InkDisplayMode enumerálásban meghatározott módon. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. Az üzenet elküldésének nincs hatása, ha a Windows XP Tablet PC Edition kiadástól eltérő operációs rendszerrel van telepítve. |
EM_GETSTATUS |
Lekéri a InkEdit vezérlő állapotát. Paraméterek: Ez az üzenet nem tartalmaz paramétereket; wParam és lParam 0-nak kell lennie. Visszaadott értékek: Ez az üzenet a InkEditStatus enumerálás egyik értékét adja vissza, amely meghatározza, hogy a vezérlő tétlen, szabadkézi elemeket gyűjt vagy felismer. |
EM_RECOGNIZE |
Kényszeríti a felismerést. Paraméterek: Ez az üzenet nem tartalmaz paramétereket; wParam és lParam 0-nak kell lennie. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_GETMOUSEICON |
Lekéri az egér ikont. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamAz aktuális MouseIcon HICON-nal kitöltött HICON* mutatót adja meg. Ez a HICON lehet HICON vagy NULL érték. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_SETMOUSEICON |
Az egér ikonjának beállítása. Paraméterek: wParamA TRUE érték igaz értékre van állítva, ha a Szabadkézi vezérlőnek a HICON-leíróval kell rendelkeznie, vagy hamis , ha az InkEdit vezérlőnek nem kell a HICON-leíróval rendelkeznie. Ha az InkEdit-vezérlő a HICON tulajdonosa, akkor megfelelően gondoskodik a HICON-ról, és megsemmisíti azt. Ellenkező esetben a hívó a HICON tulajdonosa, és a törléséért felelős. lParamAz új HICON-értéket adja meg. Az érték törléséhez használja NULL. Az alapértelmezett érték NULL. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_GETMOUSEPOINTER |
Lekéri az egérmutatót. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamInkMousePointer* mutatót tartalmaz, amely az aktuális MousePointer értékkel van kitöltve. Ez ugyanúgy viselkedik, mint a InkCollector::get_MousePointer tulajdonság. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_SETMOUSEPOINTER |
Az egérmutató beállítása. Paraméterek: wParamEz a paraméter nem használatos; 0-nak kell lennie. lParamAz új MousePointer értéket tartalmazza, amely az InkMousePointer enumerálásban van definiálva. Ez ugyanúgy viselkedik, mint a InkCollector::p ut_MousePointer tulajdonság. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. |
EM_GETUSEMOUSEFORINPUT |
Lekérdezi, hogy az egér bemenete tollbemenetként van-e kezelve. Paraméterek: Ez az üzenet nem tartalmaz paramétereket; wParam és lParam 0-nak kell lennie. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha HAMIS vagy 1-et, ha IGAZ. |
EM_SETUSEMOUSEFORINPUT |
Megadja, hogy az egér bemenete tollbemenetként legyen-e kezelve. Paraméterek: wParamEgy logikai értéket határoz meg, amely meghatározza, hogy az egér bemenetét tollbemenetként kell-e kezelni. lParamEz a paraméter nem használatos; 0-nak kell lennie. Visszaadott értékek: Ez az üzenet 0 értéket ad vissza, ha hiba történik, vagy ha hiba történik. Megjegyzések: Ezt csak akkor szabad használni, ha a EM_GETSTATUS IES_Idle ad vissza. |
Eseményértesítési üzenet | Leírás |
---|---|
IECN_STROKE |
Értesíti a InkEdit vezérlő szülőablakát arról, hogy létrejött egy IInkStrokeDisp. Ezt egy WM_NOTIFY üzenetben küldi el a rendszer az alábbi paraméterekkel. Paraméterek: wParamAz üzenetet küldő vezérlő azonosítóját adja meg. lParamA IEC_STROKEINFO struktúrára mutató mutatót ad meg. Visszaadott értékek: Az ügyfél a 0 értéket adja vissza a stroke elfogadásához, 1 pedig a stroke megszakításához. |
IECN_GESTURE |
Értesíti a InkEdit vezérlő szülőablakát, hogy felismert egy kézmozdulatot. Ezt egy WM_NOTIFY üzenetben küldi el a rendszer az alábbi paraméterekkel. Paraméterek: wParamAz üzenetet küldő vezérlő azonosítóját adja meg. lParamA IEC_GESTUREINFO szerkezet mutatóját adja meg. Visszaadott értékek: Az ügyfél 0-t ad vissza a kézmozdulat elfogadásához, 1-et pedig a kézmozdulat visszavonásához. |
IECN_RECOGNITIONRESULT |
Értesíti a InkEdit vezérlő szülőablakát arról, hogy a felismerés megtörtént. Ezt egy WM_NOTIFY üzenetben küldi el a rendszer az alábbi paraméterekkel. Paraméterek: wParamAz üzenetet küldő vezérlő azonosítóját adja meg. lParamA IEC_RECOGNITIONRESULTINFO struktúrára mutató mutatót ad meg. Visszaadott értékek: Az ügyfél 0 értéket ad vissza, ha feldolgozza az üzenetet. |