Referenční dokumentace ovládacího prvku InkPicture
Ovládací prvek InkPicture poskytuje možnost umístit obrázek do aplikace a umožnit uživatelům přidat rukopis na něj. Je určen pro scénáře, ve kterých se rukopis nerozpozná jako text, ale místo toho je uložený jako rukopis.
InkPicture ovládací prvek lze vytvořit instanci voláním CoCreateInstance metoda v C++.
Poznámka
Ovládací prvek InkPicture není označen jako bezpečný pro skriptování. Ovládací prvek InkPicture by neměl být použit v HTML nebo ASP.NET stránkách.
Vytvoření ovládacího prvku InkPicture za průhledným ovládacím prvku (například GroupBox se sadou vlastností WS_EX_TRANSPARENT) zabrání inkPicture shromažďovat rukopis.
Členové
| Výčet | Popis |
|---|---|
| InkPictureSizeMode | Definuje hodnoty, které určují, jak se obrázek na pozadí chová uvnitř ovládacího prvku InkPicture. |
| Událost | Popis |
|---|---|
| ChangeUICues | Zavrhovaný. |
| Klikněte na | Nastane, když uživatel klikne na ovládací prvek InkPicture. |
| událostiCursorButtonDown | Nastane, když InkCollector ovládací prvek zjistí IInkCursorButton objekt, který je dolů. |
| událostí CursorButtonUp | Nastane, když inkPicture ovládací prvek zjistí IInkCursorButton, který je vzhůru. |
| událostiCursorDown | Nastane, když kurzor kontaktuje digitalizační plochu tabletu. |
| událostí CursorInRange | Nastane, když kurzor přejde do rozsahu fyzické detekce (blízkosti) kontextu tabletu. |
| události CursorOutOfRange | Nastane, když kurzor opustí rozsah fyzické detekce (blízkost) kontextu tabletu. |
| DblClick | Nastane, když je ovládací prvek InkPicture poklikání. Tato metoda události je definována v rozhraní _IInkPictureEvents. Rozhraní _IInkPictureEvents implementuje rozhraní IDispatch s identifikátorem DISPID_IPEDblClick. |
| událostí gest | Nastane, když je rozpoznáno gesto aplikace. |
| událost KeyDown [Ovládací prvek InkPicture] | Nastane, když je stisknuta klávesa a na pozici dolů, zatímco ovládací prvek InkPicture má fokus. |
| událostKeyPress [Ovládací prvek InkPicture] | Nastane, když je stisknuta klávesa, zatímco ovládací prvek InkPicture má fokus. |
| událost KeyUp [Ovládací prvek InkPicture] | Nastane, když je klíč uvolněn, zatímco ovládací prvek InkPicture má fokus. |
| Událost MouseDown [Ovládací prvek InkPicture] | Nastane, když je ukazatel myši přes ovládací prvek InkPicture a je stisknuto tlačítko myši. |
| MouseEnter | Nastane, když ukazatel myši přejde do ovládacího prvku InkPicture. |
| MouseHover | Nastane, když ukazatel myši najede myší na ovládací prvek InkPicture. |
| MouseLeave | Vyvolá se, když ukazatel myši opustí ovládací prvek InkPicture. |
| Událost MouseMove [Ovládací prvek InkPicture] | Vyvolá se při přesunutí ukazatele myši přes ovládací prvek InkPicture. |
| Událost MouseUp [Ovládací prvek InkPicture] | Vyvolá se, když je ukazatel myši nad ovládacím prvku InkPicture a uvolní se tlačítko myši. |
| MouseWheel | Nastane, když se kolečko myši přesune, zatímco ovládací prvek InkPicture má fokus. |
| událostí NewInAirPackets | Nastane, když se zobrazí paket ve vzduchu. |
| událostíNewPackets | Nastane, když ovládací prvek InkPicture obdrží paket. |
| malované | Nastane, když ovládací prvek InkPicture dokončil překreslení sám sebe. |
| malování | Nastane před inkPicture ovládací prvek překreslit sám sebe. |
| změna velikosti | Nastane při změně velikosti ovládacího prvku InkPicture. |
| selectionChanged | Nastane, když se změní výběr textu v ovládacím prvku InkPicture, například prostřednictvím změn uživatelského rozhraní, procedur vyjmutí a vložení nebo vlastnosti Výběr. |
| SelectionChanging | Nastane, když výběr textu v ovládacím prvku InkPicture se chystá změnit, například prostřednictvím změn uživatelského rozhraní, procedur vyjmutí a vložení nebo Výběr vlastnost. |
| SelectionMoved | Nastane, když se změnila pozice aktuálního výběru, například prostřednictvím změn uživatelského rozhraní, postupů vyjmutí a vložení nebo vlastnosti Výběr. |
| událost SelectionMoving [InkPicture Control] | Nastane, když se chystá změnit umístění aktuálního výběru, například prostřednictvím změn uživatelského rozhraní, postupů vyjmutí a vložení nebo vlastnosti Výběr. |
| selectionResized | Nastane, když se změní velikost aktuálního výběru, například prostřednictvím změn uživatelského rozhraní, procedur vyjmutí a vložení nebo Výběr vlastnost. |
| SelectionResizing | Nastane, když se chystá změnit velikost aktuálního výběru, například prostřednictvím změn uživatelského rozhraní, postupů vyjmutí a vložení nebo vlastnosti Výběr. |
| SizeChanged | Nastane po změně velikosti ovládacího prvku InkPicture, konkrétně po změně hodnoty vlastnosti Width nebo Height. |
| SizeModeChanged | Nastane po SizeMode vlastnost InkPicture ovládacího prvku byl změněn. |
| StyleChanged | Není implementováno. |
| tahů | Nastane, když uživatel nakreslí nový tah na libovolné tabletu. |
| strokesDeleted | Nastane po IInkStrokeDisp objekty byly odstraněny z Ink vlastnost. |
| strokesDeleting | Nastane před IInkStrokeDisp objekty jsou odstraněny z Ink vlastnost. |
| SystemColorsChanged | Nastane po změně systémových barev. |
| SystemGesture | Nastane, když je rozpoznáno systémové gesto. |
| událostíTabletAdded | Nastane při přidání tabletu do systému. |
| událostí TabletRemoved | Nastane, když se tablet odebere ze systému. |
| Metoda | Popis |
|---|---|
| GetEventInterest – metoda | Vrátí hodnotu, která určuje, jestli má ovládací prvek InkPicture zájem o konkrétní událost. |
| GetGestureStatus | Vrátí hodnotu, která určuje, zda má ovládací prvek InkPicture zájem o konkrétní gesto aplikace. |
| GetWindowInputRectangle – metoda | Vrátí obdélník okna v pixelech, ve kterých je nakreslen rukopis. |
| HitTestSelection | Vrátí člen SelectionHitResult výčtu, který určuje, která část výběru( pokud existuje) byla během testu hitu nalezena. |
| SetAllTabletsMode – metoda | Umožňuje ovládacímu prvku InkPicture shromažďovat rukopis z libovolného tabletu připojeného k tabletu PC. |
| SetEventInterest – metoda | Nastaví hodnotu, která určuje, jestli má ovládací prvek InkPicture zájem o zadanou událost. |
| SetFocus | Přesune fokus na ovládací prvek InkPicture. |
| SetGestureStatus – metoda | Nastaví zájem objektu InkPicture v zadané gesto aplikace. |
| SetSingleTabletIntegratedMode – metoda | Nastaví ovládací prvek InkPicture tak, aby shromažďuje rukopis pouze z jednoho tabletu připojeného k tabletu PC. Rukopis z jiných tabletů se ignoruje. |
| SetWindowInputRectangle – metoda | Určuje obdélník okna, který se má nastavit v souřadnicích okna, ve kterých je nakreslen rukopis. |
| ShowWhatsThis | Zobrazí vybrané téma v souboru nápovědy pomocí automaticky otevíraných oken "Co je to" poskytované nápovědou v 32bitových operačních systémech Microsoft Windows (pouze v době návrhu). |
| ZOrder | Umístí ovládací prvek na přední nebo zadní stranu pořadí vykreslování v rámci své grafické úrovně (pouze návrh). |
| Vlastnost | Popis |
|---|---|
| vlastnostiAutoRedraw | Získá nebo nastaví hodnotu, která určuje, zda InkPicture ovládací prvek repaints při zrušení okna (zda InkDisp objekt, který je aktuálně přidružený k inkPicture ovládacího prvku je automaticky překreslen, když okno přidružené k InkPicture obdrží WM_PAINT zprávu). |
| BackColor | Získá nebo nastaví barvu pozadí pro inkPicture ovládacího prvku. Výchozí barva pozadí je barva pozadí systémového okna, což je obvykle bílá. |
| vlastnostCollectingInk | Získá hodnotu, která určuje, zda inkPicture ovládací prvek shromažďuje rukopis (pouze běh). |
| CollectionMode | Získá nebo nastaví režim kolekce, který určuje, zda rukopis, gesta nebo rukopis a gesta jsou rozpoznány jako uživatel zápisu. |
| kurzory | Získá IInkCursors kolekce k dispozici pro použití v oblasti rukopisu inkPicture ovládacího prvku. |
| customstrokes | Získá IInkCustomStrokes kolekci, která se má zachovat s rukopisem (pouze v době návrhu). |
| DefaultDrawingAttributes – vlastnost | Získá nebo nastaví výchozí InkDrawingAttributes kolekce použít při kreslení a zobrazení rukopisu (pouze doba běhu). |
| vlastnosti DesiredPacketDescription | Získá nebo nastaví popis paketu inkPicture ovládacího prvku (pouze doba běhu). |
| DynamicRendering – vlastnost | Získá nebo nastaví hodnotu, která určuje, zda inkPicture ovládací prvek dynamicky vykresluje rukopis při jeho shromažďování. |
| EditingMode | Získá nebo nastaví hodnotu, která určuje, zda je inkPicture ovládací prvek v režimu rukopisu, režim odstranění nebo výběr/úpravy režimu. |
| Povoleno | Získá nebo nastaví hodnotu, která určuje, zda inkPicture ovládací prvek může reagovat na uživatelem generované události. Poznámka: Tato vlastnost odpovídá vlastnosti InkEnabled. |
| EraserMode | Získá nebo nastaví hodnotu, která určuje, zda je rukopis vymazán tahem nebo bodem. |
| GumaWidth | Získá nebo nastaví hodnotu, která určuje šířku pera gumy. |
| hWnd | Získá úchyt okna, ke kterému je vázaný ovládací prvek InkPicture. (pouze doba běhu) |
| rukopisu | Získá nebo nastaví InkDisp objektu, který je přidružen k InkPicture ovládacího prvku (pouze doba běhu). |
| InkEnabled | Získá nebo nastaví hodnotu, která určuje, zda inkPicture ovládací prvek shromažďuje vstup pera (pakety ve vzduchu, kurzor v událostech rozsahu atd.). |
| vlastnostiMarginX | Získá nebo nastaví okraj osy x kolem obdélníku okna v souřadnicích obrazovky. |
| vlastnost MarginY | Získá nebo nastaví okraj osy y kolem obdélníku okna v souřadnicích obrazovky. |
| vlastnost MouseIcon | Získá nebo nastaví aktuální vlastní ikonu myši. |
| vlastnosti mousepointeru | Získá nebo nastaví hodnotu, která označuje typ ukazatele myši, který se zobrazí, když myš je přes určitou část inkPicture ovládacího prvku. |
| obrázku | Získá grafický soubor, který se zobrazí v inkPicture ovládacího prvku. |
| vlastnosti rendereru | Získá nebo nastaví InkRenderer objekt, který se používá k kreslení rukopisu na inkPicture ovládacího prvku (pouze doba běhu). |
| výběrové | Získá InkStrokes kolekce aktuálně vybraná uvnitř inkPicture ovládacího prvku (pouze doba běhu). |
| SizeMode | Získá nebo nastaví, jak ovládací prvek zpracovává umístění a změnu velikosti obrázku. |
| SupportHighContrastInk – vlastnost | Získá hodnotu, která určuje, zda je rukopis vykreslen jako pouze jedna barva, Color = COLOR_WINDOWTEXT (z volání GetSystemMetrics), pokud je systém v režimu Vysoký kontrast. |
| SupportHighContrastSelectionUI | Získá nebo nastaví hodnotu, která určuje, zda jsou všechna uživatelská rozhraní výběru (ohraničující rámeček výběru a úchyty pro výběr) vykresleny ve vysokém kontrastu, pokud je systém v režimu Vysoký kontrast. |
| vlastnostítabletu | Získá IInkTablet objekt, který InkPicture ovládací prvek aktuálně používá ke shromažďování vstupu. |
Poznámky
Uživatelské rozhraní běhu pro ovládací prvek InkPicture je okno s neprůzrakým pozadím (jednoduchá barva, pozadí obrázku nebo obojí), které obsahuje neprůzraké rukopis.
Pomocí ovládacího prvku InkPicture můžete vykreslit rukopis v systému Microsoft Windows 2000, Windows Server 2003, libovolnou edici systému Windows XP jiné než Windows XP Tablet PC Edition a jakoukoli verzi systému Windows Vista. Můžete ale zadávat rukopis, přijímat gesta nebo rozpoznávat rukopis pouze za následujících podmínek:
- Rukopis lze zadat a rozpoznat, zda je nainstalován systém Windows Vista nebo XP Tablet PC Edition 2005.
- Gesta se dají rozpoznat i.
- Rukopis lze rozpoznat jako text, pokud rukopis pochází na počítačích se staršími verzemi Windows, pokud jsou k dispozici rozpoznávání.
Pokud používáte systém Windows 2000, Windows Server 2003, libovolnou edici systému Windows XP jiné než Windows XP Tablet PC Edition 2005, můžete přiřadit hodnoty okolní vlastnosti ovládacího prvku InkPicture a pak kopírovat a vkládat rukopis do jiných aplikací. Hodnota jeho InkEnabled vlastnost bude vždy FALSE.
Trvalé InkDisp objekty lze načíst a zobrazit ve všech edicích systému Windows Vista a XP a v systémech, které mají nainstalovaný pouze sadu Windows XP Tablet PC Edition Software Development Kit (SDK). inkDisp objekty lze převést pouze na text (rozpoznaný), pokud je nainstalován systém Windows Vista nebo Windows XP Tablet PC Edition 2005.
Pokud operace na tomto ovládacím prvku nebudou úspěšné, vrátí se právní hodnota HRESULT. Pokud dojde k chybě, zkontrolujte vrácenou hodnotu HRESULT proti chybě.
Další informace o ovládacích prvcích rukopisu naleznete v tématu Rukopis.
Informace o tom, která vlákna vyvolává určité události, naleznete v tématu Vlákna, ve kterých událost může aktivovat.
Pokud chcete zvýšit výkon aplikace, ručně odstraňte ovládací prvek InkPicture, pokud už ho nepotřebujete.
Poznámka
Pokud je ovládací prvek InkPicture překryvný jiným ovládacím prvku, například GroupBox nastaven na průhlednou, inkPicture nebude shromažďovat rukopis. InkPicture musí být nejvyšší ovládací prvek v pořadí Z nebo musí být podřízeným objektem GroupBox.
Implementace modelu COM
Tento objekt implementuje IInkPicture com rozhraní.
Související témata
-
referenční ovládacích prvků InkEdit
-
třídyInkOverlay