Referens för inkpicture-kontroll
Kontrollen InkPicture ger möjlighet att placera en bild i ett program och göra det möjligt för användare att lägga till pennanteckning ovanpå den. Den är avsedd för scenarier där pennanteckning inte känns igen som text utan i stället lagras som pennanteckning.
Kontrollen InkPicture kan instansieras genom att anropa metoden CoCreateInstance i C++.
Not
Kontrollen InkPicture är inte markerad som säker för skript. Kontrollen InkPicture ska inte användas i HTML- eller ASP.NET sidor.
Om du skapar InkPicture-kontrollen bakom en transparent kontroll (till exempel en GroupBox med WS_EX_TRANSPARENT egenskapsuppsättning) förhindras InkPicture från att samla in pennanteckningar.
Medlemmar
| Uppräkning | Beskrivning |
|---|---|
| InkPictureSizeMode | Definierar värden som anger hur bakgrundsbilden beter sig i kontrollen InkPicture. |
| Händelse | Beskrivning |
|---|---|
| ChangeUICues | Deprecated. |
| klicka på | Inträffar när en användare klickar på kontrollen InkPicture. |
| CursorButtonDown-händelse | Inträffar när kontrollen InkCollector identifierar ett IInkCursorButton- objekt som är nere. |
| CursorButtonUp-händelse | Inträffar när kontrollen InkPicture identifierar en IInkCursorButton- som är igång. |
| CursorDown-händelse | Inträffar när markörspetsen kontaktar den digitaliserande surfplattans yta. |
| CursorInRange Händelse | Inträffar när en markör anger det fysiska identifieringsintervallet (närhet) för surfplattans kontext. |
| CursorOutOfRange Händelse | Inträffar när markören lämnar det fysiska identifieringsintervallet (närhet) för surfplattans kontext. |
| DblClick | Inträffar när kontrollen InkPicture dubbelklickas. Den här händelsemetoden definieras i _IInkPictureEvents-gränssnittet. _IInkPictureEvents-gränssnittet implementerar gränssnittet IDispatch med en identifierare för DISPID_IPEDblClick. |
| gesthändelse | Inträffar när en programgest identifieras. |
| KeyDown-händelse [InkPicture Control] | Inträffar när en tangent trycks ned och är i nedläge medan kontrollen InkPicture har fokus. |
| KeyPress-händelse[InkPicture Control] | Inträffar när en nyckel trycks in medan kontrollen InkPicture har fokus. |
| KeyUp-händelse [InkPicture Control] | Inträffar när en nyckel släpps medan kontrollen InkPicture har fokus. |
| MouseDown-händelse [InkPicture Control] | Inträffar när muspekaren är över kontrollen InkPicture och en musknapp trycks in. |
| MouseEnter | Inträffar när muspekaren anger kontrollen InkPicture. |
| MouseHover | Inträffar när muspekaren hovrar över kontrollen InkPicture. |
| MouseLeave | Inträffar när muspekaren lämnar kontrollen InkPicture. |
| MouseMove-händelse [InkPicture Control] | Inträffar när muspekaren flyttas över kontrollen InkPicture. |
| MouseUp-händelse [InkPicture Control] | Inträffar när muspekaren är över kontrollen InkPicture och en musknapp släpps. |
| MouseWheel | Inträffar när mushjulet flyttas medan InkPicture-kontrollen har fokus. |
| NewInAirPackets Event | Inträffar när ett in-air-paket visas. |
| NewPackets Event | Inträffar när InkPicture-kontrollen tar emot ett paket. |
| målad | Inträffar när inkpicture-kontrollen har slutfört omargningen. |
| målning | Inträffar innan InkPicture-kontrollen ritar om sig själv. |
| Ändra storlek på | Inträffar när kontrollen InkPicture ändras. |
| SelectionChanged | Inträffar när markeringen av text i kontrollen InkPicture har ändrats, till exempel genom ändringar i användargränssnittet, klipp ut och klistra in procedurer eller egenskapen Selection. |
| SelectionChanging | Inträffar när markeringen av text i kontrollen InkPicture håller på att ändras, till exempel genom ändringar i användargränssnittet, klipp ut och klistra in procedurer eller egenskapen Selection. |
| Markeringen har flyttats | Inträffar när positionen för den aktuella markeringen har ändrats, till exempel genom ändringar i användargränssnittet, klipp ut och klistra in procedurer eller egenskapen Selection. |
| SelectionMoving-händelse [InkPicture Control] | Inträffar när positionen för den aktuella markeringen håller på att ändras, till exempel genom ändringar i användargränssnittet, klipp ut och klistra in procedurer eller egenskapen Selection. |
| SelectionResized | Inträffar när storleken på den aktuella markeringen har ändrats, till exempel genom ändringar i användargränssnittet, klipp ut och klistra in procedurer eller egenskapen Selection. |
| SelectionResizing | Inträffar när storleken på den aktuella markeringen håller på att ändras, till exempel genom ändringar i användargränssnittet, klipp ut och klistra in procedurer eller egenskapen Selection. |
| SizeChanged | Inträffar efter att kontrollen InkPicture har ändrats, särskilt efter att Width eller Height egenskapsvärdet ändras. |
| SizeModeChanged | Inträffar efter att egenskapen SizeMode för Kontrollen InkPicture har ändrats. |
| StyleChanged | Inte implementerad. |
| stroke | Inträffar när användaren ritar en ny linje på valfri surfplatta. |
| StrokesDeleted | Inträffar när IInkStrokeDisp objekt har tagits bort från egenskapen Ink. |
| StrokesDeleting | Inträffar innan IInkStrokeDisp objekt tas bort från egenskapen Ink. |
| SystemColorsChanged | Inträffar när systemfärgerna har ändrats. |
| SystemGesture | Inträffar när en systemgest identifieras. |
| TabletAdded Event | Inträffar när en surfplatta läggs till i systemet. |
| TabletRemoved Event | Inträffar när en surfplatta tas bort från systemet. |
| Metod | Beskrivning |
|---|---|
| GetEventInterest-metod | Returnerar ett värde som anger om InkPicture-kontrollen har intresse för en viss händelse. |
| GetGestureStatus | Returnerar ett värde som anger om kontrollen InkPicture har intresse för en viss programgest. |
| GetWindowInputRectangle-metoden | Returnerar fönstrets rektangel, i bildpunkter, inom vilken pennanteckning ritas. |
| HitTestSelection | Returnerar en medlem i SelectionHitResult uppräkning, som anger vilken del av en markering, om någon, som träffades under ett träfftest. |
| SetAllTabletsMode-metod | Gör att InkPicture-kontrollen kan samla in pennanteckningar från alla surfplattor som är anslutna till Tablet PC. |
| SetEventInterest-metod | Anger ett värde som anger om en InkPicture-kontroll har intresse för en angiven händelse. |
| SetFocus | Flyttar fokus till kontrollen InkPicture. |
| SetGestureStatus-metod | Anger intresse för InkPicture-objektet i en angiven programgest. |
| SetSingleTabletIntegratedMode-metoden | Anger inkpicture-kontrollen för att samla in pennanteckningar från endast en surfplatta som är ansluten till Tablet PC. Pennanteckningar från andra surfplattor ignoreras. |
| SetWindowInputRectangle-metod | Anger den fönsterrektangel som ska anges i fönsterkoordinater inom vilka pennanteckningar ritas. |
| ShowWhatsThis | Visar ett markerat ämne i en hjälpfil med popup-fönstret "What's This" som tillhandahålls av Hjälp i 32-bitars Microsoft Windows-operativsystem (endast designtid). |
| ZOrder | Placerar kontrollen på framsidan eller baksidan av z-ordningen inom den grafiska nivån (endast designtid). |
| Egenskap | Beskrivning |
|---|---|
| Egenskapen AutoRedraw | Hämtar eller anger ett värde som anger om kontrollen InkPicture ommålas när fönstret är ogiltigt (om InkDisp objekt som för närvarande är associerat med kontrollen InkPicture ritas om automatiskt när fönstret som är associerat med InkPicture tar emot ett WM_PAINT meddelande). |
| BackColor | Hämtar eller anger bakgrundsfärgen för kontrollen InkPicture. Standardbakgrundsfärgen är systemfönstrets bakgrundsfärg, som vanligtvis är vit. |
| CollectingInk-egenskap | Hämtar värdet som anger om InkPicture-kontrollen samlar in pennanteckningar (endast körningstid). |
| CollectionMode | Hämtar eller anger samlingsläget som avgör om pennanteckning, gester eller pennanteckning och gester identifieras när användaren skriver. |
| egenskapen Cursors | Hämtar IInkCursors- samling som är tillgänglig för användning i InkPicture-kontrollens pennanteckningsregion. |
| CustomStrokes | Hämtar IInkCustomStrokes samling som ska bevaras med pennanteckningen (endast designtid). |
| Egenskapen DefaultDrawingAttributes | Hämtar eller anger standard InkDrawingAttributes samling som ska användas när du ritar och visar pennanteckningar (endast körningstid). |
| DesiredPacketDescription-egenskap | Hämtar eller anger paketbeskrivningen för Kontrollen InkPicture (endast körningstid). |
| DynamicRendering-egenskap | Hämtar eller anger det värde som anger om InkPicture-kontrollen dynamiskt återger pennanteckningen när den samlas in. |
| EditingMode | Hämtar eller anger ett värde som anger om kontrollen InkPicture är i pennanteckningsläge, borttagningsläge eller val/redigeringsläge. |
| aktiverat | Hämtar eller anger ett värde som avgör om InkPicture-kontrollen kan svara på användargenererade händelser. Obs! Den här egenskapen motsvarar egenskapen InkEnabled. |
| EraserMode | Hämtar eller anger det värde som anger om pennanteckning raderas med linje eller punkt. |
| EraserWidth | Hämtar eller anger det värde som anger bredden på pennspetsen för raderingspennan. |
| hWnd | Hämtar det fönsterhandtag som InkPicture-kontrollen är bunden till. (endast körningstid) |
| pennanteckning | Hämtar eller anger InkDisp- objekt som är associerat med kontrollen InkPicture (endast körningstid). |
| InkEnabled | Hämtar eller anger ett värde som anger om InkPicture-kontrollen samlar in pennindata (in-air-paket, markör i intervallhändelser och så vidare). |
| MarginX-egenskap | Hämtar eller anger x-axelmarginalen runt fönstrets rektangel i skärmkoordinater. |
| MarginY-egenskap | Hämtar eller anger y-axelns marginal runt fönstrets rektangel i skärmkoordinater. |
| Egenskapen MouseIcon | Hämtar eller anger den aktuella anpassade musikonen. |
| Egenskapen MousePointer | Hämtar eller anger ett värde som anger vilken typ av muspekare som visas när musen är över en viss del av InkPicture-kontrollen. |
| Hämtar grafikfilen som ska visas i kontrollen InkPicture. |
|
| renderaregenskap | Hämtar eller anger InkRenderer- objekt som används för att rita pennanteckningar på kontrollen InkPicture (endast körningstid). |
| val | Hämtar InkStrokes samling som för närvarande är markerad i inkpicture-kontrollen (endast körningstid). |
| SizeMode | Hämtar eller anger hur kontrollen hanterar bildplacering och storleksändring. |
| SupportHighContrastInk-egenskap | Hämtar ett värde som anger om pennanteckning återges som bara en färg, Color = COLOR_WINDOWTEXT (från GetSystemMetrics-anropet) när systemet är i högkontrastläge. |
| SupportHighContrastSelectionUI | Hämtar eller anger ett värde som anger om alla användargränssnitt för val (avgränsningsruta och markeringshandtag) ritas i hög kontrast när systemet är i högkontrastläge. |
| Tablet-egenskap | Hämtar IInkTablet- objekt som InkPicture-kontrollen använder för att samla in indata. |
Anmärkningar
Användargränssnittet för körning för InkPicture-kontrollen är ett fönster med en ogenomskinlig bakgrund (en färg, bildbakgrund eller båda) som innehåller ogenomskinlig pennanteckning.
Du kan använda inkpicture-kontrollen för att återge pennanteckningar i Microsoft Windows 2000, Windows Server 2003, alla versioner av Windows XP förutom Windows XP Tablet PC Edition och alla versioner av Windows Vista. Du kan dock mata in pennanteckning, acceptera gester eller bara känna igen handskrift under följande villkor:
- Pennanteckning kan matas in och identifieras om Windows Vista eller XP Tablet PC Edition 2005 är installerat.
- Gester kan också identifieras.
- Handskrift kan identifieras som text om handskriften har sitt ursprung på datorer som kör äldre versioner av Windows så länge som identifierare finns.
Om du använder Windows 2000, Windows Server 2003, någon annan version av Windows XP än Windows XP Tablet PC Edition 2005, kan du tilldela värden till de omgivande egenskaperna för Kontrollen InkPicture och sedan kopiera och klistra in pennanteckning till andra program. Värdet för egenskapen InkEnabled är dock alltid FALSE.
Beständiga InkDisp objekt kan läsas in och visas på alla utgåvor av Windows Vista och XP och på system som bara har Windows XP Tablet PC Edition Software Development Kit (SDK) installerat. InkDisp objekt kan bara konverteras till text (känns igen), om Windows Vista eller Windows XP Tablet PC Edition 2005 är installerat.
Om åtgärderna på den här kontrollen inte lyckas returneras en juridisk HRESULT. Om feltillstånd uppstår kontrollerar du den returnerade HRESULT mot felet.
Mer information om pennanteckningar finns i Ink.
Information om vilka trådar som genererar vissa händelser finns i Trådar där en händelse kan utlösas.
För att förbättra programmets prestanda tar du bort en InkPicture-kontroll manuellt när den inte längre behövs.
Not
När en InkPicture-kontroll överläggs med en annan kontroll, till exempel en GroupBox- inställd på transparent, samlar InkPicture inte in pennanteckningar. InkPicture måste vara den översta kontrollen i Z-ordningen eller vara underordnad GroupBox-.
COM-implementering
Det här objektet implementerar com-gränssnittet IInkPicture.