InkPicture-Steuerelementreferenz

Das InkPicture-Steuerelement bietet die Möglichkeit, ein Bild in einer Anwendung zu platzieren und Benutzern das Hinzufügen von Ink-Daten darüber zu ermöglichen. Sie ist für Szenarien vorgesehen, in denen Ink nicht als Text erkannt, sondern stattdessen als Ink gespeichert wird.

Das InkPicture-Steuerelement kann durch Aufrufen der CoCreateInstance-Methode in C++ instanziiert werden.

Hinweis

Das InkPicture-Steuerelement ist für die Skripterstellung nicht als sicher markiert. Das InkPicture-Steuerelement sollte nicht in HTML- oder ASP.NET werden.

Das Erstellen des InkPicture-Steuerelements hinter einem transparenten Steuerelement (z. B. eine GroupBox mit dem WS EX TRANSPARENT-Eigenschaftensatz) verhindert, dass _ _ InkPicture InkPicture sammelt.

Members

Enumeration Beschreibung
InkPictureSizeMode Definiert Werte, die angeben, wie sich das Hintergrundbild innerhalb des InkPicture-Steuerelements verhält.
Ereignis BESCHREIBUNG
ChangeUICues Veraltet.
Klicken Sie auf Tritt ein, wenn ein Benutzer auf das InkPicture-Steuerelement klickt.
CursorButtonDown-Ereignis Tritt ein, wenn das InkCollector-Steuerelement ein heruntergefahrenes IInkCursorButton-Objekt erkennt.
CursorButtonUp-Ereignis Tritt ein, wenn das InkPicture-Steuerelement einen IInkCursorButton erkennt, der in Der Fall ist.
CursorDown-Ereignis Tritt ein, wenn die Cursorspitze die digitalisierende Tablet-Oberfläche kontaktiert.
CursorInRange-Ereignis Tritt ein, wenn ein Cursor in den physischen Erkennungsbereich (Näherung) des Tablet-Kontexts eintritt.
CursorOutOfRange-Ereignis Tritt ein, wenn der Cursor den physischen Erkennungsbereich (Näherung) des Tablet-Kontexts verlässt.
Dblclick Tritt ein, wenn auf das InkPicture-Steuerelement doppelklickt.
Diese Ereignismethode wird in der _ IInkPictureEvents-Schnittstelle definiert. Die _ IInkPictureEvents-Schnittstelle implementiert die IDispatch-Schnittstelle mit dem Bezeichner DISPID _ IPEDblClick.
Gestenereignis Tritt ein, wenn eine Anwendungsgeste erkannt wird.
[KeyDown-Ereignis-InkPicture-Steuerelement] Tritt ein, wenn eine Taste gedrückt wird und sich in der nach unten positionierten Position befindet, während das InkPicture-Steuerelement den Fokus besitzt.
[KeyPress-Ereignis-InkPicture-Steuerelement] Tritt ein, wenn eine Taste gedrückt wird, während das InkPicture-Steuerelement den Fokus besitzt.
[KeyUp-Ereignis-InkPicture-Steuerelement] Tritt ein, wenn eine Taste freigegeben wird, während das InkPicture-Steuerelement den Fokus besitzt.
[MouseDown-Ereignis-InkPicture-Steuerelement] Tritt ein, wenn sich der Mauszeiger über dem InkPicture-Steuerelement befindet und eine Maustaste gedrückt wird.
Mouseenter Tritt ein, wenn der Mauszeiger in das InkPicture-Steuerelement eintritt.
MouseHover Tritt ein, wenn der Mauszeiger mit dem Mauszeiger auf das InkPicture-Steuerelement zeigen kann.
MouseLeave Tritt ein, wenn der Mauszeiger das InkPicture-Steuerelement verlässt.
[MouseMove-Ereignis-InkPicture-Steuerelement] Tritt ein, wenn der Mauszeiger über das InkPicture-Steuerelement bewegt wird.
[MouseUp-Ereignis-InkPicture-Steuerelement] Tritt ein, wenn sich der Mauszeiger über dem InkPicture-Steuerelement befindet und eine Maustaste losgelassen wird.
Mousewheel Tritt ein, wenn sich das Mausrad bewegt, während das InkPicture-Steuerelement den Fokus besitzt.
NewInAirPackets-Ereignis Tritt ein, wenn ein Paket in der Luft gesehen wird.
NewPackets-Ereignis Tritt ein, wenn das InkPicture-Steuerelement ein Paket empfängt.
Gemalt Tritt ein, wenn das InkPicture-Steuerelement die Neuzeichnung selbst abgeschlossen hat.
Malerei Tritt ein, bevor das InkPicture-Steuerelement sich selbst neu gedrammt.
Größe ändern Tritt ein, wenn die Größe des InkPicture-Steuerelements geändert wird.
SelectionChanged Tritt ein, wenn sich die Textauswahl im InkPicture-Steuerelement geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, durch Ausschneide- und Einfügevorgänge oder durch die Selection-Eigenschaft.
Selectionchanging Tritt ein, wenn sich die Textauswahl im InkPicture-Steuerelement ändert, z. B. durch Änderungen an der Benutzeroberfläche, Durchschneide- und Einfügevorgänge oder die Selection-Eigenschaft.
Selectionmoved Tritt ein, wenn sich die Position der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, durch Ausschneide- und Einfügevorgänge oder durch die Selection-Eigenschaft.
[SelectionMoving-EreignisinkPicture-Steuerelement] Tritt ein, wenn sich die Position der aktuellen Auswahl ändert, z. B. durch Änderungen an der Benutzeroberfläche, Durchschneide- und Einfügevorgänge oder die Selection-Eigenschaft.
Selectionresized Tritt ein, wenn sich die Größe der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, durch Ausschneide- und Einfügevorgänge oder durch die Selection-Eigenschaft.
Selectionresizing Tritt ein, wenn sich die Größe der aktuellen Auswahl ändern wird, z. B. durch Änderungen an der Benutzeroberfläche, durch Ausschneide- und Einfügevorgänge oder durch die Selection-Eigenschaft.
SizeChanged Tritt ein, nachdem die Größe des InkPicture-Steuerelements geändert wurde, insbesondere nachdem sich der Width- oder Height-Eigenschaftswert geändert hat.
SizeModeChanged Tritt ein, nachdem die SizeMode-Eigenschaft des InkPicture-Steuerelements geändert wurde.
StyleChanged Nicht implementiert.
Takt Tritt ein, wenn der Benutzer einen neuen Strich auf einem Tablet zeichnet.
Striche gelöscht Tritt ein, nachdem IInkStrokeDisp-Objekte aus der Ink-Eigenschaft gelöscht wurden.
StrokesDeleting Tritt ein, bevor IInkStrokeDisp-Objekte aus der Ink-Eigenschaft gelöscht werden.
SystemColorsChanged Tritt ein, nachdem sich die Systemfarben geändert haben.
Systemgesture Tritt ein, wenn eine Systemgeste erkannt wird.
TabletAdded-Ereignis Tritt ein, wenn dem System ein Tablet hinzugefügt wird.
TabletRemoved-Ereignis Tritt ein, wenn ein Tablet aus dem System entfernt wird.
Methode BESCHREIBUNG
GetEventInterest-Methode Gibt einen Wert zurück, der angibt, ob das InkPicture-Steuerelement an einem bestimmten Ereignis interessiert ist.
GetGestureStatus Gibt einen Wert zurück, der angibt, ob das InkPicture-Steuerelement an einer bestimmten Anwendungsgeste interessiert ist.
GetWindowInputRectangle-Methode Gibt das Fensterrechteck in Pixel zurück, innerhalb dessen Ink gezeichnet wird.
HitTestSelection Gibt einen Member der SelectionHitResult-Enumeration zurück, der angibt, welcher Teil einer Auswahl ggf. während eines Treffertests erreicht wurde.
SetAllTabletsMode-Methode Aktiviert das InkPicture-Steuerelement zum Erfassen von Inkk von jedem Tablet, das an den Tablet PC angefügt ist.
SetEventInterest-Methode Legt einen Wert fest, der angibt, ob ein InkPicture-Steuerelement an einem angegebenen Ereignis interessiert ist.
SetFocus Verschiebt den Fokus auf das InkPicture-Steuerelement.
SetGestureStatus-Methode Legt das Interesse des InkPicture-Objekts in einer angegebenen Anwendungsgeste fest.
SetSingleTabletIntegratedMode-Methode Legt das InkPicture-Steuerelement so fest, dass nur Von einem Tablet, das an den Tablet-PC angefügt ist, Ink erfasst wird. Ink von anderen Tablets wird ignoriert.
SetWindowInputRectangle-Methode Gibt das Fensterrechteck an, das in Fensterkoordinaten festgelegt werden soll, in dem Ink gezeichnet wird.
ShowWhatsThis Zeigt ein ausgewähltes Thema in einer Hilfedatei mithilfe des Popups "What es This" an, das von der Hilfe in 32-Bit-Betriebssystemen von Microsoft Windows bereitgestellt wird (nur Entwurfszeit).
Zorder Platziert das Steuerelement am Anfang oder hinter der Z-Reihenfolge auf seiner grafischen Ebene (nur Entwurfszeit).
Eigenschaft BESCHREIBUNG
AutoRedraw-Eigenschaft Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das InkPicture-Steuerelement neu gezeichnet wird, wenn das Fenster ungültig wird (ob das derzeit dem InkPicture-Steuerelement zugeordnete InkDisp-Objekt automatisch neu gezeichnet wird, wenn das der InkPicture zugeordnete Fenster eine WM_PAINT Meldung empfängt).
Backcolor Ruft die Hintergrundfarbe für das InkPicture-Steuerelement ab oder legt diese fest. Die Standardhintergrundfarbe ist die Hintergrundfarbe des Systemfensters, die in der Regel weiß ist.
CollectingInk-Eigenschaft Ruft den Wert ab, der angibt, ob das InkPicture-Steuerelement inkk erfasst (nur Laufzeit).
CollectionMode Ruft den Auflistungsmodus ab, der bestimmt, ob Ink, Gesten oder Ink und Gesten beim Schreiben des Benutzers erkannt werden, oder legt diesen fest.
Cursors-Eigenschaft Ruft die IInkCursors-Auflistung ab, die für die Verwendung im Freihandbereich des InkPicture-Steuerelements verfügbar ist.
Customstrokes Ruft die IInkCustomStrokes-Auflistung ab, die mit der Freihandeingabe beibehalten werden soll (nur zur Entwurfszeit).
DefaultDrawingAttributes-Eigenschaft Ruft die Standardmäßige InkDrawingAttributes-Auflistung ab, die beim Zeichnen und Anzeigen von Ink verwendet werden soll (nur laufzeit).
DesiredPacketDescription-Eigenschaft Ruft die Paketbeschreibung des InkPicture-Steuerelements ab (nur Laufzeit) oder legt diese fest.
DynamicRendering-Eigenschaft Ruft den Wert ab, der angibt, ob das InkPicture-Steuerelement die InkPicture-Steuerelement dynamisch rendert, während sie gesammelt wird, oder legt diesen fest.
Editingmode Ruft einen Wert ab, der angibt, ob sich das InkPicture-Steuerelement im Inkk-Modus, im Löschmodus oder im Auswahl-/Bearbeitungsmodus befindet, oder legt diesen fest.
Aktiviert Ruft einen Wert ab, der bestimmt, ob das InkPicture-Steuerelement auf vom Benutzer generierte Ereignisse reagieren kann, oder legt diesen fest.
[!Note]
Diese Eigenschaft entspricht der InkEnabled-Eigenschaft.

EraserMode Ruft den Wert ab, der angibt, ob Ink durch Strich oder Punkt gelöscht wird, oder legt diesen fest.
EraserWidth Ruft den Wert ab, der die Breite der Radiererstiftspitze angibt, oder legt diesen fest.
Hwnd Ruft das Fensterhandle ab, an das das InkPicture-Steuerelement gebunden ist. (nur Laufzeit)
Freihand Ruft das InkDisp-Objekt ab, das dem InkPicture-Steuerelement zugeordnet ist (nur Laufzeit), oder legt es fest.
Inkenabled Ruft einen Wert ab, der angibt, ob das InkPicture-Steuerelement Stifteingaben sammelt (In-Air-Pakete, Cursor in Bereichsereignissen usw.), oder legt diesen fest.
MarginX-Eigenschaft Ruft den X-Achsenrand um das Fensterrechteck in Bildschirmkoordinaten ab oder legt den Rand fest.
MarginY-Eigenschaft Ruft den Rand der y-Achse um das Fensterrechteck in Bildschirmkoordinaten ab oder legt den Rand fest.
MouseIcon-Eigenschaft Ruft das aktuelle benutzerdefinierte Maussymbol ab oder legt dieses fest.
MousePointer-Eigenschaft Ruft einen Wert ab, der den Typ des Mauszeigers angibt, der angezeigt wird, wenn sich die Maus über einem bestimmten Teil des InkPicture-Steuerelements befindet, oder legt diesen fest.
Bild Ruft die Grafikdatei ab, die im InkPicture-Steuerelement angezeigt werden soll.
Renderereigenschaft Ruft das InkRenderer-Objekt ab, das zum Zeichnen von InkPicture-Steuerelementen verwendet wird (nur Laufzeit), oder legt dieses fest.
Auswahl Ruft die Auflistung "InkStrokes" ab, die derzeit im InkPicture-Steuerelement ausgewählt ist (nur Laufzeit).
Größenanpassung Ruft ab oder legt fest, wie das Steuerelement die Bildplatzierung und -dimensionierung behandelt.
SupportHighContrastInk-Eigenschaft Ruft einen Wert ab, der angibt, ob Ink als nur eine Farbe gerendert wird, Color = COLOR_WINDOWTEXT (aus dem GetSystemMetrics-Aufruf), wenn sich das System im hoher Kontrast Modus befindet.
SupportHighContrastSelectionUI Ruft einen Wert ab, der angibt, ob alle Auswahlbenutzeroberflächen (Auswahlgrenzenfeld und Auswahlhandles) in hohem Kontrast gezeichnet werden, wenn sich das System im hoher Kontrast Modus befindet, oder legt diesen fest.
Tablet-Eigenschaft Ruft das IInkTablet-Objekt ab, das das InkPicture-Steuerelement derzeit zum Erfassen von Eingaben verwendet.

Bemerkungen

Die Benutzeroberfläche der Laufzeit für das InkPicture-Steuerelement ist ein Fenster mit einem nicht transparenten Hintergrund (einzelne Farbe, Bildhintergrund oder beides), das nicht transparente Farben enthält.

Sie können das InkPicture-Steuerelement verwenden, um Inkk in Microsoft Windows 2000, Windows Server 2003, einer beliebigen Edition von Windows XP außer Windows XP Tablet PC Edition und einer beliebigen Version von Windows Vista zu rendern. Sie können freihandeingaben, Gesten akzeptieren oder Handschrift nur unter den folgenden Bedingungen erkennen:

  • Ink kann eingegeben und erkannt werden, wenn Windows Vista oder XP Tablet PC Edition 2005 installiert ist.
  • Gesten können auch erkannt werden.
  • Handschrift kann als Text erkannt werden, wenn die Handschrift auf Computern mit älteren Versionen von Windows stammt, solange Erkennungen vorhanden sind.

Wenn Sie Windows 2000, Windows Server 2003, eine beliebige Edition von Windows XP außer Windows XP Tablet PC Edition 2005 verwenden, können Sie den Umgebungseigenschaften des InkPicture-Steuerelements Werte zuweisen und dann Inkk kopieren und in andere Anwendungen einfügen. Der Wert der InkEnabled-Eigenschaft ist jedoch immer FALSE.

Persistente InkDisp-Objekte können in allen Editionen von Windows Vista und XP sowie auf Systemen geladen und angezeigt werden, auf denen nur das Windows XP Tablet PC Edition Software Development Kit (SDK) installiert ist. InkDisp-Objekte können nur in Text konvertiert (erkannt) werden, wenn Windows Vista oder die Windows XP Tablet PC Edition 2005 installiert ist.

Wenn Vorgänge für dieses Steuerelement nicht erfolgreich sind, wird ein rechtliches HRESULT zurückgegeben. Wenn Fehlerbedingungen auftreten, überprüfen Sie das zurückgegebene HRESULT auf den Fehler.

Weitere Informationen zu Ink-Steuerelementen finden Sie unter Ink.

Informationen darüber, welche Threads bestimmte Ereignisse auslösen, finden Sie unter Threads, für die ein Ereignis ausgelöst werden kann.

Um die Leistung Ihrer Anwendung zu verbessern, löschen Sie ein InkPicture-Steuerelement manuell, wenn es nicht mehr benötigt wird.

Hinweis

Wenn ein InkPicture-Steuerelement mit einem anderen Steuerelement überlagert wird, z. B. ein GroupBox-Steuerelement, das auf transparent festgelegt ist, erfasst inkPicture keine InkPicture-Ink-Objekte. InkPicture muss das oberste Steuerelement in der Z-Reihenfolge sein, oder es muss ein untergeordnetes Element der GroupBox sein.

COM-Implementierung

Dieses Objekt implementiert die IInkPicture-COM-Schnittstelle.

InkEdit-Steuerelementreferenz

InkOverlay-Klasse