InkPicture-Steuerelementreferenz

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

Das InkPicture-Steuerelement kann instanziiert werden, indem die CoCreateInstance-Methode in C++ aufgerufen wird.

Hinweis

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

Durch das Erstellen des InkPicture-Steuerelements hinter einem transparenten Steuerelement (z. B. einem GroupBox mit dem WS_EX_TRANSPARENT-Eigenschaftssatz) wird verhindert, dass InkPicture Freihandeingaben sammelt.

Member

Enumeration Beschreibung
InkPictureSizeMode Definiert Werte, die angeben, wie sich das Hintergrundbild innerhalb des InkPicture-Steuerelements verhält.
Ereignis BESCHREIBUNG
ChangeUICues Veraltet.
Klicken Tritt auf, wenn ein Benutzer auf das InkPicture-Steuerelement klickt.
CursorButtonDown-Ereignis Tritt auf, wenn das InkCollector-Steuerelement ein IInkCursorButton-Objekt erkennt, das nach unten liegt.
CursorButtonUp-Ereignis Tritt auf, wenn das InkPicture-Steuerelement ein IInkCursorButton erkennt, das nach oben ist.
CursorDown-Ereignis Tritt auf, wenn der Cursortipp die Ziffer der Tablet-Oberfläche kontaktiert.
CursorInRange-Ereignis Tritt auf, wenn ein Cursor den physischen Erkennungsbereich (Näherung) des Tablet-Kontexts eingibt.
CursorOutOfRange-Ereignis Tritt auf, wenn der Cursor den physischen Erkennungsbereich (Näherung) des Tablet-Kontexts verlässt.
DblClick Tritt auf, wenn das InkPicture-Steuerelement doppelklicken wird.
Diese Ereignismethode wird in der _IInkPictureEvents Schnittstelle definiert. Die _IInkPictureEvents-Schnittstelle implementiert die IDispatch-Schnittstelle mit einem Bezeichner von DISPID_IPEDblClick.
Gestenereignis Tritt auf, wenn eine Anwendungsgeste erkannt wird.
KeyDown-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn eine TASTE gedrückt und in der Abwärtsposition steht, während das InkPicture-Steuerelement den Fokus hat.
KeyPress-Ereignis[InkPicture-Steuerelement] Tritt auf, wenn eine Taste gedrückt wird, während das InkPicture-Steuerelement den Fokus hat.
KeyUp-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn ein Schlüssel freigegeben wird, während das InkPicture-Steuerelement den Fokus hat.
MouseDown-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn der Mauszeiger über das InkPicture-Steuerelement liegt und eine Maustaste gedrückt wird.
Mouseenter Tritt auf, wenn der Mauszeiger das InkPicture-Steuerelement eingibt.
MouseHover Tritt auf, wenn der Mauszeiger über das InkPicture-Steuerelement bewegt wird.
MouseLeave Tritt auf, wenn der Mauszeiger das InkPicture-Steuerelement verlässt.
MouseMove-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn der Mauszeiger über das InkPicture-Steuerelement verschoben wird.
MouseUp-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn sich der Mauszeiger über das InkPicture-Steuerelement befindet und eine Maustaste losgelassen wird.
Mousewheel Tritt auf, wenn das Mausrad bewegt wird, während das InkPicture-Steuerelement den Fokus hat.
NewInAirPackets-Ereignis Tritt auf, wenn ein In-Air-Paket angezeigt wird.
NewPackets-Ereignis Tritt auf, wenn das InkPicture-Steuerelement ein Paket empfängt.
Gemalt Tritt auf, wenn das InkPicture-Steuerelement das Neuraen selbst abgeschlossen hat.
Malerei Tritt auf, bevor sich das InkPicture-Steuerelement selbst neu ergibt.
Größe Tritt auf, wenn das InkPicture-Steuerelement geändert wird.
SelectionChanged Tritt auf, wenn sich die Auswahl von Text innerhalb des InkPicture-Steuerelements geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, Ausschneiden und Einfügen von Prozeduren oder der Selection-Eigenschaft .
Selectionchanging Tritt auf, wenn sich die Auswahl von Text im InkPicture-Steuerelement ändert, z. B. durch Änderungen an der Benutzeroberfläche, Ausschneiden und Einfügen von Prozeduren oder der Selection-Eigenschaft .
Selectionmoved Tritt auf, wenn sich die Position der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, Ausschneiden und Einfügen von Prozeduren oder der Selection-Eigenschaft .
SelectionMoving-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn sich die Position der aktuellen Auswahl ändert, z. B. durch Änderungen an der Benutzeroberfläche, Ausschneiden und Einfügen von Prozeduren oder der Selection-Eigenschaft .
Selectionresized Tritt auf, wenn sich die Größe der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, Ausschneiden und Einfügen von Prozeduren oder der Selection-Eigenschaft .
Selectionresizing Tritt auf, wenn sich die Größe der aktuellen Auswahl ändert, z. B. durch Änderungen an der Benutzeroberfläche, Ausschneiden und Einfügen von Prozeduren oder der Selection-Eigenschaft .
SizeChanged Tritt auf, nachdem das InkPicture-Steuerelement geändert wurde, insbesondere nach Änderung des Werts der Width - oder Height-Eigenschaft .
SizeModeChanged Tritt auf, nachdem die SizeMode-Eigenschaft des InkPicture-Steuerelements geändert wurde.
StyleChanged Nicht implementiert.
Takt Tritt auf, wenn der Benutzer einen neuen Strich auf jedem Tablet zeichnet.
StricheDeleted Tritt auf, nachdem IInkStrokeDisp-Objekte aus der Ink-Eigenschaft gelöscht wurden.
StrokesDeleting Tritt auf, bevor IInkStrokeDisp-Objekte aus der Ink-Eigenschaft gelöscht werden.
SystemColorsChanged Tritt auf, nachdem sich die Systemfarben geändert haben.
Systemgesture Tritt auf, wenn eine Systemgeste erkannt wird.
TabletAdded-Ereignis Tritt auf, wenn dem System ein Tablet hinzugefügt wird.
TabletRemoved-Ereignis Tritt auf, wenn ein Tablet aus dem System entfernt wird.
Methode BESCHREIBUNG
GetEventInterest-Methode Gibt einen Wert zurück, der angibt, ob das InkPicture-Steuerelement interesse an einem bestimmten Ereignis hat.
GetGestureStatus Gibt einen Wert zurück, der angibt, ob das InkPicture-Steuerelement interesse an einer bestimmten Anwendungsgeste hat.
GetWindowInputRectangle-Methode Gibt das Fensterrechteck in Pixel zurück, in dem Freihand gezeichnet wird.
HitTestSelection Gibt ein Element der SelectionHitResult-Aufzählung zurück, die angibt, welche Teil einer Auswahl, falls vorhanden, während eines Treffertests getroffen wurde.
SetAllTabletsMode-Methode Ermöglicht das InkPicture-Steuerelement das Sammeln von Freihandeingaben aus jedem Tablet, das an den Tablet-PC angefügt ist.
SetEventInterest-Methode Legt einen Wert fest, der angibt, ob ein InkPicture-Steuerelement interesse an einem angegebenen Ereignis hat.
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 fest, um Freihand von nur einem Tablet zu sammeln, das an den Tablet-PC angefügt ist. Freihand aus anderen Tablets wird ignoriert.
SetWindowInputRectangle-Methode Gibt das Fensterrechteck an, das in Fensterkoordinaten festgelegt werden soll, innerhalb derer Freihand gezeichnet wird.
ShowWhatsThis Zeigt ein ausgewähltes Thema in einer Hilfedatei mit dem Popup "Was ist dies" an, das von Hilfe in 32-Bit-Microsoft Windows Betriebssystemen (nur Entwurfszeit) bereitgestellt wird.
Zorder Platziert das Steuerelement an der Vorder- oder Rückseite der Z-Reihenfolge in seiner grafischen Ebene (nur Entwurfszeit).
Eigenschaft BESCHREIBUNG
AutoRedraw-Eigenschaft Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das InkPicture-Steuerelement beim Ungültigen des Fensters erneut eingefügt wird ( ob das InkDisp-Objekt, das derzeit dem InkPicture-Steuerelement zugeordnet ist, automatisch neu gezeichnet wird, wenn das Fenster, das der InkPicture zugeordnet ist, eine WM_PAINT Nachricht empfängt).
BackColor Ruft die Hintergrundfarbe für das InkPicture-Steuerelement ab oder legt diese fest. Die Standardhintergrundfarbe ist die Hintergrundfarbe des Systemfensters, die normalerweise weiß ist.
CollectingInk-Eigenschaft Ruft den Wert ab, der angibt, ob das InkPicture-Steuerelement Freihand sammelt (nur Laufzeit).
CollectionMode Dient zum Abrufen oder Festlegen des Auflistungsmodus, der bestimmt, ob Freihand, Gesten oder Freihandeingaben und Gesten beim Schreiben des Benutzers erkannt werden.
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 Freihand (nur Entwurfszeit) beibehalten werden soll.
DefaultDrawingAttributes-Eigenschaft Ruft die Standardmäßige InkDrawingAttributes-Auflistung ab, die beim Zeichnen und Anzeigen von Freihand verwendet werden soll (nur Laufzeit).
DesiredPacketDescription-Eigenschaft Dient zum Abrufen oder Festlegen der Paketbeschreibung des InkPicture-Steuerelements (nur Laufzeit).
DynamicRendering-Eigenschaft Dient zum Abrufen oder Festlegen des Werts, der angibt, ob das InkPicture-Steuerelement die Freihand dynamisch gerendert, da er erfasst wird.
Editingmode Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob sich das InkPicture-Steuerelement im Freihandmodus, im Löschmodus oder im Bearbeitungsmodus befindet.
Aktiviert Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob das InkPicture-Steuerelement auf benutzergenerierte Ereignisse reagieren kann.
[! Hinweis]
Diese Eigenschaft entspricht der InkEnabled-Eigenschaft .

EraserMode Dient zum Abrufen oder Festlegen des Werts, der angibt, ob Freihand durch Strich oder Punkt gelöscht wird.
RadiererWidth Ruft den Wert ab oder legt den Wert fest, der die Breite der Radiererstift-Tipp angibt.
hWnd Ruft den Fensterpunkt ab, an den das InkPicture-Steuerelement gebunden ist. (nur Laufzeit)
Freihand Ruft das InkDisp-Objekt ab, das dem InkPicture-Steuerelement zugeordnet ist (nur Laufzeit).
Inkenabled Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das InkPicture-Steuerelement Stifteingaben (In-Air-Pakete, Cursor in Bereichsereignissen usw.) erfasst.
MarginX-Eigenschaft Ruft den X-Achsenrand um das Fensterrechteck in Bildschirmkoordinaten ab oder legt sie fest.
Marginy-Eigenschaft Ruft den y-Achsenrand um das Fensterrechteck in Bildschirmkoordinaten ab oder legt sie fest.
MouseIcon-Eigenschaft Ruft das aktuelle benutzerdefinierte Maussymbol ab oder legt diese fest.
MousePointer-Eigenschaft Ruft einen Wert ab oder legt einen Wert fest, der den Mauszeigertyp angibt, der angezeigt wird, wenn die Maus über einen bestimmten Teil des InkPicture-Steuerelements liegt.
Picture Ruft die Grafikdatei ab, die im InkPicture-Steuerelement angezeigt werden soll.
Renderer-Eigenschaft Dient zum Abrufen oder Festlegen des InkRenderer-Objekts , das zum Zeichnen von Freihand auf dem InkPicture-Steuerelement (nur Laufzeit) verwendet wird.
Auswahl Ruft die InkStrokes-Auflistung ab, die derzeit innerhalb des InkPicture-Steuerelements ausgewählt ist (nur Laufzeit).
Größenanpassung Ruft ab oder legt fest, wie das Steuerelement die Bildplatzierung und Größe behandelt.
SupportHighContrastInk-Eigenschaft Ruft einen Wert ab, der angibt, ob Freihand als nur eine Farbe gerendert wird, Color = COLOR_WINDOWTEXT (aus dem GetSystemMetrics-Aufruf), wenn sich das System im Modus "Hoher Kontrast" befindet.
SupportHighContrastSelectionUI Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob alle Auswahlbenutzerschnittstellen (Auswahlgrenzenfeld und Auswahlpunkte) im hohen Kontrast gezeichnet werden, wenn das System im Modus "Hoher Kontrast" ist.
Tablet-Eigenschaft Ruft das IInkTablet-Objekt ab, das das InkPicture-Steuerelement derzeit zum Sammeln von Eingaben verwendet.

Hinweise

Die Laufzeit-Benutzeroberfläche für das InkPicture-Steuerelement ist ein Fenster mit einem undurchsichtigen Hintergrund (einzelne Farbe, Bildhintergrund oder beides), das undurchsichtige Freihandeingaben enthält.

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

  • Freihandeingaben können eingaben 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, jede Edition von Windows XP außer Windows XP Tablet PC Edition 2005 verwenden, können Sie den Umgebungseigenschaften des InkPicture-Steuerelements Werte zuweisen, und fügen Sie Freihand in andere Anwendungen ein. Der Wert seiner InkEnabled-Eigenschaft ist jedoch immer FALSE.

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

Wenn Vorgänge auf diesem 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 Freihandsteuerelementen finden Sie unter Freihand.

Informationen dazu, welche Threads bestimmte Ereignisse auslösen, finden Sie unter Threads, in denen ein Ereignis ausgelöst werden kann.

Um die Leistung Ihrer Anwendung zu verbessern, löschen Sie manuell ein InkPicture-Steuerelement, wenn sie 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, sammelt die InkPicture keine Freihandeingabe. Die InkPicture muss das oberste Steuerelement in der Z-Reihenfolge sein, oder es muss ein untergeordnetes Element des GroupBox-Elements sein.

COM-Implementierung

Dieses Objekt implementiert die IInkPicture COM-Schnittstelle.

InkEdit-Steuerelementreferenz

InkOverlay-Klasse