Naslaginformatie over InkPicture-besturingselementen
Het besturingselement InkPicture biedt de mogelijkheid om een afbeelding in een toepassing te plaatsen en gebruikers in staat te stellen om er inkt aan toe te voegen. Het is bedoeld voor scenario's waarin inkt niet wordt herkend als tekst, maar in plaats daarvan wordt opgeslagen als inkt.
Het besturingselement InkPicture kan worden geïnstantieerd door de methode CoCreateInstance aan te roepen in C++.
Notitie
Het besturingselement InkPicture is niet gemarkeerd als veilig voor het uitvoeren van scripts. Het besturingselement InkPicture mag niet worden gebruikt in HTML- of ASP.NET pagina's.
Als u het besturingselement InkPicture achter een transparant besturingselement (zoals een GroupBox met de set WS_EX_TRANSPARENT eigenschap) maakt, voorkomt u dat InkPicture inkt verzamelt.
Leden
| Opsomming | Beschrijving |
|---|---|
| InkPictureSizeMode | Definieert waarden die aangeven hoe de achtergrondafbeelding zich gedraagt in het Besturingselement InkPicture. |
| Gebeurtenis | Beschrijving |
|---|---|
| ChangeUICues- | Verouderd. |
| klik op | Treedt op wanneer een gebruiker op het besturingselement InkPicture klikt. |
| CursorButtonDown-gebeurtenis | Treedt op wanneer het besturingselement InkCollector een IInkCursorButton object detecteert dat niet beschikbaar is. |
| CursorButtonUp-gebeurtenis | Treedt op wanneer het besturingselement InkPicture een IInkCursorButton detecteert dat is ingesteld. |
| CursorDown-gebeurtenis | Treedt op wanneer de cursortip contact opdoet met het digitaliserende tabletoppervlak. |
| CursorInRange-gebeurtenis | Treedt op wanneer een cursor het fysieke detectiebereik (nabijheid) van de tabletcontext binnenkomt. |
| CursorOutOfRange-gebeurtenis | Treedt op wanneer de cursor het fysieke detectiebereik (nabijheid) van de tabletcontext verlaat. |
| DblClick | Treedt op wanneer op het besturingselement InkPicture wordt gedubbelklikt. Deze gebeurtenismethode wordt gedefinieerd in de _IInkPictureEvents-interface. De _IInkPictureEvents-interface implementeert de IDispatch-interface met een id van DISPID_IPEDblClick. |
| gebeurtenisgebeurtenis | Treedt op wanneer een toepassingsbeweging wordt herkend. |
| KeyDown-gebeurtenis [InkPicture Control] | Treedt op wanneer een toets wordt ingedrukt en in de omlaagpositie terwijl het besturingselement InkPicture de focus heeft. |
| KeyPress Event[InkPicture Control] | Treedt op wanneer een toets wordt ingedrukt terwijl het besturingselement InkPicture de focus heeft. |
| KeyUp-gebeurtenis [InkPicture Control] | Treedt op wanneer een sleutel wordt vrijgegeven terwijl het Besturingselement InkPicture de focus heeft. |
| MouseDown-gebeurtenis [InkPicture Control] | Treedt op wanneer de muis aanwijzer boven het besturingselement InkPicture staat en een muisknop wordt ingedrukt. |
| MouseEnter- | Treedt op wanneer de muiswijzer het besturingselement InkPicture binnenkomt. |
| MouseHover- | Treedt op wanneer de muisaanwijzer boven het besturingselement InkPicture beweegt. |
| MouseLeave- | Treedt op wanneer de muis aanwijzer het Besturingselement InkPicture verlaat. |
| MouseMove-gebeurtenis [InkPicture Control] | Treedt op wanneer de muis aanwijzer wordt verplaatst over het Besturingselement InkPicture. |
| MouseUp-gebeurtenis [InkPicture Control] | Treedt op wanneer de muis aanwijzer boven het Besturingselement InkPicture staat en er een muisknop wordt losgelaten. |
| MouseWheel- | Treedt op wanneer het muiswiel beweegt terwijl het InkPicture-besturingselement de focus heeft. |
| NewInAirPackets Event | Treedt op wanneer een pakket in de lucht wordt gezien. |
| NewPackets Event | Treedt op wanneer het InkPicture-besturingselement een pakket ontvangt. |
| geschilderde | Treedt op wanneer het besturingselement InkPicture zelf opnieuw is getekend. |
| schilderij | Vindt plaats voordat het InkPicture-besturingselement zichzelf opnieuw tekent. |
| formaat van wijzigen | Treedt op wanneer het formaat van het besturingselement InkPicture wordt gewijzigd. |
| SelectionChanged | Treedt op wanneer de selectie van tekst in het Besturingselement InkPicture is gewijzigd, zoals door wijzigingen in de gebruikersinterface, knip- en plakprocedures of de eigenschap Selectie. |
| SelectionChanging- | Treedt op wanneer de selectie van tekst in het besturingselement InkPicture op het punt staat te veranderen, bijvoorbeeld door wijzigingen in de gebruikersinterface, knip- en plakprocedures of de eigenschap Selection. |
| Selectie verplaatst | Treedt op wanneer de positie van de huidige selectie is gewijzigd, zoals door wijzigingen in de gebruikersinterface, knip- en plakprocedures of de eigenschap Selectie. |
| SelectionMoving Event [InkPicture Control] | Treedt op wanneer de positie van de huidige selectie op het punt staat te veranderen, zoals door wijzigingen in de gebruikersinterface, knip- en plakprocedures of de eigenschap Selectie. |
| SelectionResized- | Treedt op wanneer de grootte van de huidige selectie is gewijzigd, zoals door wijzigingen in de gebruikersinterface, knip- en plakprocedures of de eigenschap Selectie. |
| SelectionResizing | Treedt op wanneer de grootte van de huidige selectie op het punt staat te veranderen, zoals door wijzigingen in de gebruikersinterface, knip- en plakprocedures of de eigenschap Selectie. |
| SizeChanged | Vindt plaats nadat het formaat van het besturingselement InkPicture is gewijzigd, met name nadat de Width of Height eigenschapswaarde is gewijzigd. |
| SizeModeChanged- | Vindt plaats nadat de eigenschap SizeMode van het Besturingselement InkPicture is gewijzigd. |
| StyleChanged | Niet geïmplementeerd. |
| Treedt op wanneer de gebruiker een nieuwe pennenstreek op een tablet tekent. |
|
| StrokesDeleted | Vindt plaats nadat IInkStrokeDisp--objecten zijn verwijderd uit de eigenschap Inkt. |
| StrokesDeleting | Vindt plaats voordat IInkStrokeDisp--objecten worden verwijderd uit de eigenschap Inkt. |
| SystemColorsChanged- | Vindt plaats nadat de systeemkleuren zijn gewijzigd. |
| SystemGesture | Treedt op wanneer een systeembeweging wordt herkend. |
| TabletAdded Event | Treedt op wanneer een tablet wordt toegevoegd aan het systeem. |
| TabletRemoved Event | Treedt op wanneer een tablet uit het systeem wordt verwijderd. |
| Methode | Beschrijving |
|---|---|
| MethodeGetEventInterest | Retourneert een waarde die aangeeft of het besturingselement InkPicture interesse heeft in een bepaalde gebeurtenis. |
| GetGestureStatus | Retourneert een waarde die aangeeft of het besturingselement InkPicture interesse heeft in een bepaalde toepassingsbeweging. |
| methode GetWindowInputRectangle | Retourneert de rechthoek van het venster, in pixels, waarin inkt wordt getekend. |
| HitTestSelection- | Retourneert een lid van de SelectionHitResult opsomming, waarmee wordt aangegeven welk deel van een selectie, indien aanwezig, tijdens een hittest is geraakt. |
| MethodeSetAllTabletsMode | Hiermee kan het inkPicture-besturingselement inkt verzamelen van een tablet die is aangesloten op de tablet-pc. |
| Methode SetEventInterest | Hiermee stelt u een waarde in die aangeeft of een InkPicture-besturingselement interesse heeft in een opgegeven gebeurtenis. |
| SetFocus | Hiermee verplaatst u de focus naar het besturingselement InkPicture. |
| MethodeSetGestureStatus | Hiermee stelt u het belang van het Object InkPicture in een opgegeven toepassingsbeweging in. |
| methode SetSingleTabletIntegratedMode | Hiermee stelt u het besturingselement InkPicture in om inkt te verzamelen van slechts één tablet die is aangesloten op de tablet-pc. Inkt van andere tablets wordt genegeerd. |
| Methode SetWindowInputRectangle | Hiermee geeft u de rechthoek van het venster op om in te stellen, in venstercoördinaten, waarin inkt wordt getekend. |
| ShowWhatsThis | Geeft een geselecteerd onderwerp weer in een Help-bestand met behulp van de pop-up 'Wat is dit' die wordt aangeboden door Help in 32-bits besturingssystemen van Microsoft Windows (alleen ontwerptijd). |
| ZOrder | Hiermee plaatst u het besturingselement aan de voor- of achterkant van de z-volgorde binnen het grafische niveau (alleen ontwerptijd). |
| Eigenschap | Beschrijving |
|---|---|
| autoredraw-eigenschap | Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het InkPicture-besturingselement opnieuw wordt aangegeven wanneer het venster ongeldig is (of het InkDisp--object dat momenteel is gekoppeld aan Het Besturingselement InkPicture automatisch opnieuw wordt getekend wanneer het venster dat is gekoppeld aan de InkPicture een WM_PAINT bericht ontvangt). |
| BackColor- | Hiermee haalt u de achtergrondkleur voor het Besturingselement InkPicture op of stelt u deze in. De standaardachtergrondkleur is de achtergrondkleur van het systeemvenster, die meestal wit is. |
| Property CollectingInk | Hiermee haalt u de waarde op die aangeeft of het inkPicture-besturingselement inkt verzamelt (alleen runtime). |
| CollectionMode | Hiermee haalt u de verzamelingsmodus op die bepaalt of inkt, bewegingen of inkt en bewegingen worden herkend als de gebruiker schrijft. |
| eigenschap Cursors | Hiermee wordt de IInkCursors verzameling opgehaald die beschikbaar is voor gebruik in de inktregio van het InkPicture-besturingselement. |
| CustomStrokes- | Hiermee haalt u de IInkCustomStrokes verzameling op om te worden bewaard met de inkt (alleen ontwerptijd). |
| eigenschap DefaultDrawingAttributes | Hiermee haalt of stelt u de standaardverzameling InkDrawingAttributes te gebruiken bij het tekenen en weergeven van inkt (alleen runtime). |
| eigenschap DesiredPacketDescription | Haalt de pakketbeschrijving van het InkPicture-besturingselement op of stelt deze in (alleen runtime). |
| dynamicrendering-eigenschap | Hiermee haalt u de waarde op die aangeeft of het inkPicture-besturingselement de inkt dynamisch weergeeft terwijl deze wordt verzameld. |
| EditingMode | Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of het besturingselement InkPicture zich in de inktmodus, verwijderingsmodus bevindt of de modus voor selecteren/bewerken. |
| ingeschakelde | Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt bepaald of het besturingselement InkPicture kan reageren op door de gebruiker gegenereerde gebeurtenissen. Opmerking: Deze eigenschap is gelijk aan de eigenschap InkEnabled. |
| Gummode- | Hiermee wordt de waarde opgehaald of ingesteld waarmee wordt aangegeven of inkt wordt gewist door pennenstreek of punt. |
| GumWidth- | Hiermee wordt de waarde opgehaald of ingesteld waarmee de breedte van de gumpentip wordt opgegeven. |
| hWnd- | Hiermee haalt u de venstergreep op waaraan het besturingselement InkPicture is gebonden. (alleen runtime) |
| inkt- | Hiermee wordt het InkDisp--object opgehaald of ingesteld dat is gekoppeld aan het Besturingselement InkPicture (alleen runtime). |
| InkEnabled- | Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het inkPicture-besturingselement peninvoer verzamelt (in-air pakketten, cursor in bereikgebeurtenissen, enzovoort). |
| marginx-eigenschap | Hiermee haalt u de x-asmarge rond de rechthoek van het venster in schermcoördinaten op of stelt u deze in. |
| marginy-eigenschap | Hiermee haalt u de marge van de y-as rond de rechthoek van het venster in schermcoördinaten op of stelt u deze in. |
| MouseIcon Property | Hiermee haalt u het huidige aangepaste muispictogram op of stelt u deze in. |
| mousepointer-eigenschap | Hiermee wordt een waarde opgehaald of ingesteld waarmee het type muis aanwijzer wordt aangegeven dat wordt weergegeven wanneer de muis over een bepaald deel van het Besturingselement InkPicture loopt. |
| afbeelding | Hiermee wordt het grafische bestand weergegeven in het besturingselement InkPicture. |
| renderereigenschap | Hiermee haalt u het InkRenderer object op dat wordt gebruikt om inkt te tekenen op het Besturingselement InkPicture (alleen runtime). |
| selectie | Hiermee haalt u de InkStrokes verzameling op die momenteel is geselecteerd in het Besturingselement InkPicture (alleen runtime). |
| SizeMode | Hiermee haalt u op of stelt u in hoe het besturingselement de plaatsing en grootte van afbeeldingen verwerkt. |
| eigenschap SupportHighContrastInk | Hiermee wordt een waarde opgehaald die aangeeft of inkt wordt weergegeven als slechts één kleur, Color = COLOR_WINDOWTEXT (uit de aanroep GetSystemMetrics) wanneer het systeem zich in de modus Hoog contrast bevindt. |
| SupportHighContrastSelectionUI | Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of alle selectiegebruikersinterfaces (selectiekader en selectiegrepen) in hoog contrast worden getekend wanneer het systeem zich in de modus Hoog contrast bevindt. |
| tableteigenschap | Hiermee haalt u het IInkTablet--object op dat het besturingselement InkPicture momenteel gebruikt om invoer te verzamelen. |
Opmerkingen
De runtimegebruikersinterface voor het Besturingselement InkPicture is een venster met een ondoorzichtige achtergrond (één kleur, afbeeldingsachtergrond of beide) die ondoorzichtige inkt bevat.
U kunt het besturingselement InkPicture gebruiken om inkt weer te geven in Microsoft Windows 2000, Windows Server 2003, elke editie van Windows XP anders dan Windows XP Tablet PC Edition en elke versie van Windows Vista. U kunt echter inkt invoeren, bewegingen accepteren of handschrift alleen herkennen onder de volgende voorwaarden:
- Inkt kan worden ingevoerd en herkend als Windows Vista of XP Tablet PC Edition 2005 is geïnstalleerd.
- Bewegingen kunnen ook worden herkend.
- Handschrift kan worden herkend als tekst als het handschrift afkomstig is van computers met oudere versies van Windows, zolang recognizers aanwezig zijn.
Als u Windows 2000, Windows Server 2003, een andere editie van Windows XP dan Windows XP Tablet PC Edition 2005 gebruikt, kunt u waarden toewijzen aan de omgevingseigenschappen van het Besturingselement InkPicture en vervolgens inkt kopiëren en plakken in andere toepassingen. De waarde van de eigenschap InkEnabled wordt echter altijd ONWAAR.
Persistente InkDisp--objecten kunnen worden geladen en weergegeven op alle edities van Windows Vista en XP en op systemen waarop alleen de Windows XP Tablet PC Edition Software Development Kit (SDK) is geïnstalleerd. InkDisp--objecten kunnen alleen worden geconverteerd naar tekst (herkend), als Windows Vista of de Windows XP Tablet PC Edition 2005 is geïnstalleerd.
Als bewerkingen op dit besturingselement niet slagen, wordt een juridisch HRESULT geretourneerd. Als het resultaat van foutvoorwaarden is, controleert u het geretourneerde HRESULT op basis van de fout.
Zie Inkt-voor meer informatie over inktbesturingselementen.
Zie Threads waarop een gebeurtenis kan worden geactiveerdvoor informatie over welke threads bepaalde gebeurtenissen veroorzaken.
Als u de prestaties van uw toepassing wilt verbeteren, moet u handmatig een InkPicture-besturingselement verwijderen wanneer deze niet meer nodig is.
Notitie
Wanneer een InkPicture-besturingselement wordt overlays met een ander besturingselement, zoals een GroupBox ingesteld op transparant, verzamelt de InkPicture geen inkt. De InkPicture moet het meest bovenste besturingselement in de Z-volgorde zijn of moet een onderliggend element van de GroupBoxzijn.
COM-implementatie
Met dit object wordt de IInkPicture COM-interface geïmplementeerd.