Megosztás a következőn keresztül:

InkPicture Control Reference

  • Cikk

Az InkPicture vezérlő lehetővé teszi, hogy képeket helyezzen el egy alkalmazásban, és lehetővé tegye a felhasználók számára, hogy szabadkézatot vegyenek fel rá. Olyan forgatókönyvekhez készült, amelyekben a szabadkévet nem szövegként ismeri fel a rendszer, hanem szabadkémában tárolja.

Az InkPicture vezérlő a C++-ban a CoCreateInstance metódus meghívásával hozható létre.

Jegyzet

Az InkPicture vezérlő nincs biztonságosként megjelölve a szkripteléshez. Az InkPicture vezérlő nem használható HTML-ben vagy ASP.NET oldalakon.

Az InkPicture vezérlő transzparens vezérlőelem (például a WS_EX_TRANSPARENT tulajdonságkészlettel rendelkező GroupBox) mögötti létrehozása megakadályozza, hogy az InkPicture szabadkézik.

Tagok

Felsorolás Leírás
InkPictureSizeMode Olyan értékeket határoz meg, amelyek meghatározzák, hogyan viselkedik a háttérkép az InkPicture vezérlőelemen belül.
Esemény Leírás
ChangeUICues Elavult.
Kattintson a Akkor fordul elő, ha egy felhasználó az InkPicture vezérlőre kattint.
CursorButtonDown esemény Akkor fordul elő, ha a InkCollector vezérlő észlel egy IInkCursorButton objektumot, amely nem működik.
CursorButtonUp esemény Akkor fordul elő, ha az InkPicture vezérlő egy IInkCursorButton észlel.
CursorDown esemény Ez akkor fordul elő, ha a kurzorhegy érintkezik a digitalizáló táblagép felületével.
CursorInRange esemény Akkor fordul elő, ha a kurzor a táblagép környezetének fizikai észlelési tartományába (közelségébe) lép.
CursorOutOfRange esemény Akkor fordul elő, ha a kurzor elhagyja a táblagép környezetének fizikai észlelési tartományát (közelségét).
DblClick Akkor fordul elő, ha az InkPicture vezérlőre duplán kattint.
Ez az eseménymetódus a _IInkPictureEvents felületen van definiálva. A _IInkPictureEvents felület implementálja a IDispatch interfészt DISPID_IPEDblClick azonosítójával.
Kézmozdulat esemény Az alkalmazás kézmozdulatának felismerésekor fordul elő.
KeyDown-esemény [InkPicture Control] A billentyű lenyomásakor és lefelé állásban, az InkPicture vezérlő fókusza alatt történik.
KeyPress Event[InkPicture Control] Akkor fordul elő, ha egy billentyűt lenyom, miközben az InkPicture vezérlő fókuszban van.
KeyUp esemény [InkPicture Control] Akkor fordul elő, ha egy kulcs ki van adva, miközben az InkPicture vezérlőelem fókuszba kerül.
MouseDown-esemény [InkPicture Control] Ez akkor fordul elő, ha az egérmutató az InkPicture vezérlő fölé kerül, és az egérgombot lenyomja.
MouseEnter Akkor fordul elő, ha az egérmutató belép az InkPicture vezérlőbe.
MouseHover Akkor fordul elő, ha az egérmutató az InkPicture vezérlő fölé mutat.
MouseLeave Akkor fordul elő, ha az egérmutató elhagyja az InkPicture vezérlőt.
MouseMove esemény [InkPicture Control] Akkor fordul elő, ha az egérmutató az InkPicture vezérlő fölé kerül.
MouseUp esemény [InkPicture Control] Akkor fordul elő, ha az egérmutató az InkPicture vezérlő fölé kerül, és az egérgomb felengedve jelenik meg.
Egérkerék Akkor fordul elő, ha az egérkerék mozog, miközben az InkPicture vezérlő fókuszban van.
NewInAirPackets esemény Akkor fordul elő, ha egy légi csomag látható.
NewPackets esemény Akkor fordul elő, ha az InkPicture vezérlő csomagot fogad.
festett Akkor fordul elő, ha az InkPicture vezérlő befejezte az újrarajzolást.
festési Az InkPicture vezérlő újraírása előtt következik be.
átméretezése Az InkPicture vezérlő átméretezésekor fordul elő.
SelectionChanged Ez akkor fordul elő, ha az InkPicture vezérlőben a szöveg kijelölése megváltozott, például a felhasználói felület módosítása, a kivágás és beillesztési eljárások vagy a Kijelölés tulajdonság.
SelectionChanging Akkor fordul elő, ha az InkPicture vezérlőelemen belül a szöveg kijelölése megváltozik, például a felhasználói felület módosítása, a kivágási és beillesztési eljárások vagy a Kijelölés tulajdonság.
SelectionMoved Ez akkor fordul elő, ha az aktuális kijelölés pozíciója megváltozott, például a felhasználói felület módosítása, a kivágási és beillesztési eljárások vagy a Kijelölés tulajdonság.
SelectionMoving event [InkPicture Control] Ez akkor fordul elő, ha az aktuális kijelölés pozíciója megváltozik, például a felhasználói felület módosítása, a kivágás és beillesztési eljárások vagy a Kijelölés tulajdonság.
SelectionResized Akkor fordul elő, ha az aktuális kijelölés mérete megváltozott, például a felhasználói felület módosítása, a kivágási és beillesztési eljárások vagy a Kijelölés tulajdonság.
SelectionResizing Akkor fordul elő, ha az aktuális kijelölés mérete megváltozik, például a felhasználói felület módosítása, a kivágás és beillesztés eljárások vagy a Kijelölés tulajdonság.
SizeChanged Az InkPicture vezérlő átméretezése után következik be, különösen a Szélesség vagy Magasság tulajdonságértékének módosítása után.
SizeModeChanged Az InkPicture vezérlő SizeMode tulajdonságának módosítása után következik be.
StyleChanged Nincs implementálva.
Stroke Akkor fordul elő, ha a felhasználó új tollvonást rajzol bármelyik táblagépre.
Törölt körvonalak Az IInkStrokeDispobjektumokSzabadkézi tulajdonságból való törlése után következik be.
StrokesDeleting Mielőtt IInkStrokeDisp objektumokat törölne a Szabadkézi tulajdonságból.
SystemColorsChanged A rendszer színváltozása után következik be.
SystemGesture Rendszermozdulatok felismerésekor fordul elő.
Táblacímes esemény Akkor fordul elő, ha egy táblagépet adnak hozzá a rendszerhez.
TabletRemoved esemény Akkor fordul elő, ha egy táblagépet eltávolítanak a rendszerből.
Módszer Leírás
GetEventInterest metódus Olyan értéket ad vissza, amely jelzi, hogy az InkPicture vezérlőelemnek van-e érdeklődése egy adott esemény iránt.
GetGestureStatus Olyan értéket ad vissza, amely jelzi, hogy az InkPicture vezérlőelemnek van-e érdeklődése egy adott alkalmazásmozdulat iránt.
GetWindowInputRectangle metódus Az ablak téglalapját adja vissza képpontban, amelyen belül szabadkévet rajzol.
HitTestSelection A SelectionHitResult enumerálásának egy tagját adja vissza, amely meghatározza, hogy egy kijelölés mely részét érte el a találati teszt.
SetAllTabletsMode metódus Lehetővé teszi az InkPicture vezérlő számára, hogy a táblagéphez csatlakoztatott bármely táblagépről gyűjtsön szabadkévet.
SetEventInterest metódus Beállít egy értéket, amely jelzi, hogy egy InkPicture-vezérlőnek van-e érdekeltsége egy adott eseményben.
SetFocus A fókusz áthelyezése az InkPicture vezérlőre.
SetGestureStatus metódus Beállítja az InkPicture objektum érdeklődését egy adott alkalmazásmozdulatban.
SetSingleTabletIntegratedMode metódus Az InkPicture vezérlőt úgy állítja be, hogy csak egy táblagépről gyűjtsön szabadkévet a Táblagép PC-hez csatlakoztatva. A többi táblagépről származó szabadkévek figyelmen kívül lesznek hagyva.
SetWindowInputRectangle metódus Megadja az ablakkoordinátákban beállítandó ablak téglalapját, amelyen belül szabadkézett szabadkézettel dolgozik.
ShowWhatsThis Egy súgófájlban kijelölt témakört jelenít meg a Súgó által a 32 bites Microsoft Windows operációs rendszerekben biztosított "What's This" előugró ablakban (csak tervezési idő).
ZOrder A vezérlőt a z-rendelés elején vagy hátulján helyezi el a grafikus szinten (csak tervezési idő).
Ingatlan Leírás
Automatikus helyreállítás tulajdonság Lekéri vagy beállít egy értéket, amely meghatározza, hogy az InkPicture vezérlő újrafesti-e az ablakot (hogy a InkDisp objektum jelenleg az InkPicture vezérlőelemhez van-e társítva, automatikusan újrarajzolva, amikor az InkPicture-hez társított ablak WM_PAINT üzenetet kap).
BackColor Lekéri vagy beállítja az InkPicture vezérlő háttérszínét. Az alapértelmezett háttérszín a rendszerablak háttérszíne, amely általában fehér.
CollectingInk tulajdonság Lekéri azt az értéket, amely meghatározza, hogy az InkPicture vezérlő szabadkézi elemeket gyűjt-e (csak futási idő).
CollectionMode Lekéri vagy beállítja a gyűjtési módot, amely meghatározza, hogy a felhasználó íráskor felismerje-e a szabadkézi elemeket, a kézmozdulatokat, a szabadkézi elemeket és a kézmozdulatokat.
Kurzorok tulajdonság Lekéri az IInkCursors gyűjteményt az InkPicture vezérlő szabadkézi régiójában való használatra.
CustomStrokes Lekéri a IInkCustomStrokes gyűjteményt a szabadkézi elemekkel (csak tervezési idő).
DefaultDrawingAttributes tulajdonság Lekéri vagy beállítja az alapértelmezett InkDrawingAttributes gyűjteményt a szabadkézi elemek rajzolásakor és megjelenítésekor (csak futási idő).
DesiredPacketDescription tulajdonság Lekéri vagy beállítja az InkPicture vezérlő csomagleírását (csak futási idő).
DynamicRendering tulajdonság Lekéri vagy beállítja azt az értéket, amely meghatározza, hogy az InkPicture vezérlő dinamikusan rendereli-e a szabadkézi elemeket az adatgyűjtés során.
EditingMode Lekéri vagy beállít egy értéket, amely meghatározza, hogy az InkPicture vezérlő szabadkézi módban, törlési módban vagy kijelölési/szerkesztési módban van-e.
engedélyezett Lekéri vagy beállít egy értéket, amely meghatározza, hogy az InkPicture vezérlő képes-e válaszolni a felhasználó által létrehozott eseményekre.
Megjegyzés: Ez a tulajdonság egyenértékű a InkEnabled tulajdonságával.
Radírmode Lekéri vagy beállítja azt az értéket, amely meghatározza, hogy a szabadkézi elemeket vonás vagy pont alapján törli-e a rendszer.
Radírwidth Lekéri vagy beállítja a radír tollhegy szélességét meghatározó értéket.
hWnd Lekéri azt az ablakfogópontot, amelyhez az InkPicture vezérlő van kötve. (csak futási idő)
szabadkéta Lekéri vagy beállítja az InkPicture vezérlőelemhez társított InkDisp objektumot (csak futási idő).
InkEnabled Lekéri vagy beállít egy értéket, amely meghatározza, hogy az InkPicture vezérlő összegyűjti-e a toll bemenetét (a levegőben lévő csomagokat, a kurzort a tartományeseményekben stb.).
MarginX tulajdonság Lekéri vagy beállítja az x tengely margóját az ablak téglalapja körül képernyőkoordinátákban.
Marginy tulajdonság Lekéri vagy beállítja az y tengely margóját az ablak téglalapja körül képernyőkoordinátákban.
MouseIcon tulajdonság Lekéri vagy beállítja az aktuális egyéni egérikont.
MousePointer tulajdonság Lekéri vagy beállít egy értéket, amely azt jelzi, hogy milyen típusú egérmutató jelenik meg, ha az egér az InkPicture vezérlő egy adott része felett van.
Kép A grafikus fájl megjelenik az InkPicture vezérlőn.
Renderer tulajdonság Lekéri vagy beállítja a InkRenderer objektumot, amely szabadkézi elemeket rajzol az InkPicture vezérlőn (csak futási idő).
kijelölési Lekéri a InkStrokes gyűjteményt, amely jelenleg az InkPicture vezérlőben van kiválasztva (csak futási idő).
SizeMode Beolvashatja vagy beállíthatja, hogy a vezérlő hogyan kezeli a képek elhelyezését és méretezését.
SupportHighContrastInk tulajdonság Olyan értéket kap, amely meghatározza, hogy a szabadkézi elemek csak egy színként jelennek-e meg, Szín = COLOR_WINDOWTEXT (a GetSystemMetrics hívásból), ha a rendszer kontrasztos módban van.
SupportHighContrastSelectionUI Lekéri vagy beállít egy értéket, amely meghatározza, hogy a rendszer kontrasztos módban rajzolja-e az összes kijelölési felhasználói felületet (kijelölési határolókeret és kijelölőfogópontok).
Táblagép tulajdonság Lekéri a IInkTablet objektumot, amelyet az InkPicture vezérlő jelenleg a bemenetek gyűjtésére használ.

Megjegyzések

Az InkPicture vezérlő futásidejű felhasználói felülete egy átlátszatlan (egyszínű, képháttér vagy mindkettő) háttérrel rendelkező ablak, amely átlátszatlan szabadkéziket tartalmaz.

Az InkPicture vezérlőt használhatja a Szabadkézon való megjelenítéshez a Microsoft Windows 2000, a Windows Server 2003, a Windows XP bármely kiadása, a Windows XP Tablet PC Edition és a Windows Vista bármely verziójában. Azonban csak a következő feltételek mellett adhat meg szabadkévet, elfogadhat kézmozdulatokat, vagy felismerheti a kézírást:

  • A szabadkéz beírható és felismerhető, ha telepítve van a Windows Vista vagy XP Tablet PC Edition 2005.
  • A kézmozdulatok is felismerhetők.
  • A kézírás akkor ismerhető fel szövegként, ha a kézírás a Windows régebbi verzióit futtató gépekről származik, amíg a felismerők jelen vannak.

Ha a Windows 2000, a Windows Server 2003 vagy a Windows XP bármely kiadását használja a Windows XP Tablet PC Edition 2005-ös kiadásától eltérően, értékeket rendelhet az InkPicture vezérlő környezeti tulajdonságaihoz, majd más alkalmazásokba másolhatja és beillesztheti a szabadkézen. Az InkEnabled tulajdonság értéke azonban mindig HAMISlesz.

A megőrzött InkDisp objektumok betölthetők és megjeleníthetők a Windows Vista és XP összes kiadásában, valamint olyan rendszereken, amelyeken csak a Windows XP Tablet PC Edition Software Development Kit (SDK) van telepítve. InkDisp objektumok csak akkor konvertálhatók szöveggé (felismerhetővé), ha telepítve van a Windows Vista vagy a Windows XP Tablet PC Edition 2005.

Ha az ellenőrzésen végzett műveletek nem sikerülnek, a rendszer egy jogi HRESULT-t ad vissza. Ha a hibafeltételek eredményül adnak, ellenőrizze a visszaadott HRESULT értéket a hibával szemben.

A szabadkéta-vezérlőkről további információt Szabadkézcímű témakörben talál.

További információ arról, hogy mely szálak emelnek ki bizonyos eseményeket, lásd olyan szálakat, amelyeken egy esemény aktiválhat.

Az alkalmazás teljesítményének javítása érdekében manuálisan távolítsa el az InkPicture vezérlőt, ha már nincs rá szükség.

Jegyzet

Ha egy InkPicture-vezérlőt egy másik vezérlővel , például egy GroupBox átlátszóra van állítva, az InkPicture nem gyűjt szabadkézatot. Az InkPicture-nek a Z-sorrend legfelső vezérlőjének kell lennie, vagy a GroupBoxgyermekének kell lennie.

COM-implementáció

Ez az objektum implementálja az IInkPicture COM-felületet.

InkEdit Control Reference

InkOverlay osztály