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 .