Freigeben über


InkPicture-Steuerelementreferenz

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

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

Hinweis

Das InkPicture-Steuerelement ist nicht als sicher für Skripterstellung markiert. 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-Steuerelement mit WS_EX_TRANSPARENT Eigenschaftensatz) 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 ausgefallen ist.
CursorButtonUp-Ereignis Tritt auf, wenn das InkPicture-Steuerelement ein IInkCursorButton erkennt, das aktiv ist.
CursorDown-Ereignis Tritt auf, wenn die Cursorspitze die digitalisierte Tablet-Oberfläche kontaktiert.
CursorInRange-Ereignis Tritt auf, wenn ein Cursor in den physischen Erkennungsbereich (Nähe) des Tablet-Kontexts eingibt.
CursorOutOfRange-Ereignis Tritt auf, wenn der Cursor den physischen Erkennungsbereich (Nähe) des Tablet-Kontexts verlässt.
DblClick Tritt auf, wenn auf das InkPicture-Steuerelement doppelklicken wird.
Diese Ereignismethode wird in der _IInkPictureEvents-Schnittstelle definiert. Die _IInkPictureEvents-Schnittstelle implementiert die IDispatch-Schnittstelle mit dem Bezeichner DISPID_IPEDblClick.
Gestenereignis Tritt auf, wenn eine Anwendungsgeste erkannt wird.
KeyDown-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn eine Taste gedrückt wird und sich in der position nach unten befindet, 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 eine Taste losgelassen wird, während das InkPicture-Steuerelement den Fokus hat.
MouseDown-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn sich der Mauszeiger über dem InkPicture-Steuerelement befindet und eine Maustaste gedrückt wird.
Mouseenter Tritt auf, wenn der Mauszeiger in das InkPicture-Steuerelement eintritt.
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 bewegt wird.
MouseUp-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn sich der Mauszeiger über dem 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 die Neuzeichnung selbst abgeschlossen hat.
Zeichnen Tritt auf, bevor das InkPicture-Steuerelement sich selbst neu zeichnet.
Größe ändern Tritt auf, wenn die Größe des InkPicture-Steuerelements geändert wird.
SelectionChanged Tritt auf, wenn sich die Textauswahl innerhalb des InkPicture-Steuerelements geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, durch Ausschneiden und Einfügen von Prozeduren oder durch die Selection-Eigenschaft .
Selectionchanging Tritt auf, wenn sich die Textauswahl im InkPicture-Steuerelement ändert, z. B. durch Änderungen an der Benutzeroberfläche, durch Ausschneiden und Einfügen oder durch die Selection-Eigenschaft .
Selectionmoved Tritt auf, wenn sich die Position der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, durch Ausschneiden und Einfügen von Prozeduren oder durch die Selection-Eigenschaft .
SelectionMoving-Ereignis [InkPicture-Steuerelement] Tritt auf, wenn sich die Position der aktuellen Auswahl ändert, z. B. durch Änderungen an der Benutzeroberfläche, Durchschneiden und Einfügen von Prozeduren oder die Selection-Eigenschaft .
Selectionresized Tritt auf, wenn sich die Größe der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, Durchschneiden und Einfügen von Prozeduren oder durch die Selection-Eigenschaft .
Selectionresizing Tritt auf, wenn sich die Größe der aktuellen Auswahl ändert, z. B. durch Änderungen an der Benutzeroberfläche, Durchschneiden und Einfügen von Prozeduren oder die Selection-Eigenschaft .
SizeChanged Tritt auf, nachdem die Größe des InkPicture-Steuerelements geändert wurde, insbesondere nachdem sich der Width - oder Height-Eigenschaftswert geändert hat.
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 einem Tablet zeichnet.
StricheLöscht Tritt auf, nachdem IInkStrokeDisp-Objekte aus der Ink-Eigenschaft gelöscht wurden.
StricheLöschen 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 Pixeln zurück, in dem Freihand gezeichnet wird.
HitTestSelection Gibt ein Element der SelectionHitResult-Enumeration zurück, das angibt, welcher Teil einer Auswahl (falls vorhanden) während eines Treffertests getroffen wurde.
SetAllTabletsMode-Methode Ermöglicht dem InkPicture-Steuerelement das Sammeln von Freihand von jedem Tablet, das an den Tablet-PC angeschlossen 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 an einer angegebenen Anwendungsgeste fest.
SetSingleTabletIntegratedMode-Methode Legt das InkPicture-Steuerelement so fest, dass freihand von nur einem Tablet erfasst wird, das an den Tablet-PC angeschlossen ist. Freihandeingaben von anderen Tablets werden ignoriert.
SetWindowInputRectangle-Methode Gibt das festzulegende Fensterrechteck in Fensterkoordinaten an, in dem Freihand gezeichnet wird.
ShowWhatsThis Zeigt ein ausgewähltes Thema in einer Hilfedatei mithilfe des Popupfensters "What's This" an, das von Hilfe in 32-Bit-Microsoft Windows-Betriebssystemen bereitgestellt wird (nur Entwurfszeit).
Zorder Platziert das Steuerelement auf der Vorder- oder Rückseite der Z-Reihenfolge innerhalb seiner grafischen Ebene (nur Entwurfszeit).
Eigenschaft BESCHREIBUNG
AutoRedraw-Eigenschaft Ruft einen Wert ab, der angibt, ob das InkPicture-Steuerelement neu erstellt wird, wenn das Fenster ungültig ist (ob das Derzeit dem InkPicture-Steuerelement inkPicture zugeordnete InkDisp-Objekt automatisch neu gezeichnet wird, wenn das der InkPicture zugeordnete Fenster 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 in der Regel weiß ist.
CollectingInk-Eigenschaft Ruft den Wert ab, der angibt, ob das InkPicture-Steuerelement Freihand sammelt (nur Laufzeit).
CollectionMode Ruft den Auflistungsmodus ab, der bestimmt, ob Freihand, Gesten oder Freihand und Gesten beim Schreiben des Benutzers erkannt werden, oder legt diesen fest.
Cursors-Eigenschaft Ruft die IInkCursors-Auflistung ab, die zur Verwendung im Freihandbereich des InkPicture-Steuerelements verfügbar ist.
Customstrokes Ruft die IInkCustomStrokes-Auflistung ab, die mit der Freihand beibehalten werden soll (nur Entwurfszeit).
DefaultDrawingAttributes-Eigenschaft Ruft die Standardmäßige InkDrawingAttributes-Auflistung ab, die beim Zeichnen und Anzeigen von Freihand verwendet werden soll (nur Laufzeit).
DesiredPacketDescription-Eigenschaft Ruft die Paketbeschreibung des InkPicture-Steuerelements ab oder legt sie fest (nur Laufzeit).
DynamicRendering-Eigenschaft Ruft den Wert ab, der angibt, ob das InkPicture-Steuerelement die Freihandeingabe beim Sammeln dynamisch rendert, oder legt ihn fest.
Editingmode Ruft einen Wert ab, der angibt, ob sich das InkPicture-Steuerelement im Freihandmodus, 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.
Hinweis: Diese Eigenschaft entspricht der InkEnabled-Eigenschaft .
EraserMode Ruft den Wert ab, der angibt, ob Freihand 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 Dem InkPicture-Steuerelement zugeordnete InkDisp-Objekt ab oder legt es fest (nur Laufzeit).
Inkenabled Ruft einen Wert ab, der angibt, ob das InkPicture-Steuerelement Stifteingaben sammelt (In-Air-Pakete, Cursor in Bereichsereignissen usw.).
MarginX-Eigenschaft Ruft den X-Achsenrand um das Fensterrechteck in Bildschirmkoordinaten ab oder legt diese fest.
MarginY-Eigenschaft Ruft den Rand der y-Achse um das Fensterrechteck in Bildschirmkoordinaten ab oder legt diese fest.
MouseIcon-Eigenschaft Ruft das aktuelle benutzerdefinierte Maussymbol ab oder legt es fest.
MousePointer-Eigenschaft Ruft einen Wert ab, der den Mauszeigertyp 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 wird.
Renderer-Eigenschaft Ruft das InkRenderer-Objekt ab, das zum Zeichnen von Freihand für das InkPicture-Steuerelement verwendet wird (nur Laufzeit).
Auswahl Ruft die InkStrokes-Auflistung ab, die derzeit im InkPicture-Steuerelement ausgewählt ist (nur Laufzeit).
Größenanpassung Ruft ab oder legt fest, wie das Steuerelement die Bildplatzierung und -größe verarbeitet.
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 Ruft einen Wert ab, der angibt, ob alle Auswahlbenutzeroberflächen (Auswahlbegrenzungsfeld und Auswahlhandles) in hohem Kontrast gezeichnet werden, wenn sich das System im Modus "Hoher Kontrast" befindet, oder legt diesen fest.
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 (einzelfarbig, Bildhintergrund oder beides), das undurchsichtige Freihand enthält.

Sie können das InkPicture-Steuerelement verwenden, um Freihand in Microsoft Windows 2000, Windows Server 2003, jeder Edition von Windows XP mit Ausnahme von Windows XP Tablet PC Edition und jeder Version von Windows Vista zu rendern. Sie können freihand eingeben, Gesten akzeptieren oder Handschriften nur unter den folgenden Bedingungen erkennen:

  • Freihandeingaben können eingegeben und erkannt werden, wenn Windows Vista oder XP Tablet PC Edition 2005 installiert ist.
  • Gesten können ebenfalls erkannt werden.
  • Handschrift kann als Text erkannt werden, wenn die Handschrift auf Computern mit älteren Windows-Versionen 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 Freihand in andere Anwendungen kopieren und einfügen. Der Wert der InkEnabled-Eigenschaft ist jedoch immer FALSE.

Persistente InkDisp-Objekte können in allen Editionen von Windows Vista und XP und 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 dann in Text konvertiert werden (erkannt), wenn Windows Vista oder 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 Freihandsteuerelementen finden Sie unter Freihand.

Informationen dazu, 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, verwerfen Sie manuell ein InkPicture-Steuerelement, wenn es nicht mehr benötigt wird.

Hinweis

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

COM-Implementierung

Dieses Objekt implementiert die IInkPicture-COM-Schnittstelle .

InkEdit-Steuerelementreferenz

InkOverlay-Klasse