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. Sie ist für Szenarien vorgesehen, in denen Freihandeingaben nicht als Text erkannt werden, sondern als Freihand gespeichert werden.
Das InkPicture-Steuerelement kann instanziiert werden, indem die CoCreateInstance--Methode in C++ aufgerufen wird.
Anmerkung
Das InkPicture-Steuerelement ist für Skripts nicht als sicher gekennzeichnet. Das InkPicture-Steuerelement sollte nicht in HTML- oder ASP.NET Seiten verwendet werden.
Das Erstellen des InkPicture-Steuerelements hinter einem transparenten Steuerelement (z. B. ein GroupBox-Steuerelement mit dem WS_EX_TRANSPARENT-Eigenschaftensatz) verhindert, dass InkPicture Freihand sammelt.
Angehörige
| Aufzählung | Beschreibung |
|---|---|
| InkPictureSizeMode | Definiert Werte, die angeben, wie sich das Hintergrundbild innerhalb des InkPicture-Steuerelements verhält. |
| Ereignis | Beschreibung |
|---|---|
| ChangeUICues | Veraltet. |
| Klicken sie auf | 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 ist. |
| CursorButtonUp-Ereignis | Tritt auf, wenn das InkPicture-Steuerelement eine IInkCursorButton- erkennt, die aktiv ist. |
| CursorDown-Ereignis | Tritt auf, wenn die Cursorspitze die digitalisierungsierende Tablet-Oberfläche kontaktiert. |
| CursorInRange-Ereignis- | Tritt auf, wenn ein Cursor in den physischen Erkennungsbereich (Näherung) des Tablet-Kontexts wechselt. |
| CursorOutOfRange-Ereignis | Tritt auf, wenn der Cursor den physischen Erkennungsbereich (Näherung) des Tablet-Kontexts verlässt. |
| DblClick- | Tritt auf, wenn auf das InkPicture-Steuerelement doppelklickt 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 Control] | Tritt auf, wenn eine Taste gedrückt wird und sich in der Abwärtsposition befindet, während das InkPicture-Steuerelement den Fokus hat. |
| KeyPress-Ereignis[InkPicture Control] | Tritt auf, wenn eine Taste gedrückt wird, während das InkPicture-Steuerelement den Fokus hat. |
| KeyUp-Ereignis [InkPicture Control] | Tritt auf, wenn eine Taste losgelassen wird, während das InkPicture-Steuerelement den Fokus hat. |
| MouseDown-Ereignis [InkPicture Control] | 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 wechselt. |
| 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 Control] | Tritt auf, wenn der Mauszeiger über das InkPicture-Steuerelement verschoben wird. |
| MouseUp-Ereignis [InkPicture Control] | 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. |
| Malen | Tritt auf, wenn das InkPicture-Steuerelement die Neuzeichnung abgeschlossen hat. |
| Malen | Tritt auf, bevor sich das InkPicture-Steuerelement selbst neu gezeichnet. |
| Ändern der Größe | 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, Ausschneiden und Einfügen von Prozeduren oder die Selection-Eigenschaft. |
| SelectionChanging- | Tritt auf, wenn sich die Textauswahl 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 die Selection-Eigenschaft. |
| SelectionMoving-Ereignis [InkPicture Control] | 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 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, Ausschneiden und Einfügen von Prozeduren oder die 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 die Selection-Eigenschaft. |
| SizeChanged- | Tritt ein, nachdem die Größe des InkPicture-Steuerelements geändert wurde, insbesondere nachdem sich der Wert der Width oder Height Eigenschaft geändert hat. |
| SizeModeChanged- | Tritt ein, nachdem die SizeMode- -Eigenschaft des InkPicture -Steuerelements geändert wurde. |
| StyleChanged- | Nicht implementiert. |
| Strich- | Tritt auf, wenn der Benutzer einen neuen Strich auf einem beliebigen Tablet zeichnet. |
| StrokesDeleted- | Tritt ein, 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 ein, 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, welcher Teil einer Auswahl (falls vorhanden) während eines Treffertests getroffen wurde. |
| SetAllTabletsMode-Methode | Ermöglicht das InkPicture-Steuerelement das Sammeln von Freihandeingaben 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 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 angeschlossen ist. Freihand aus anderen Tablets wird 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 Popups "What's This" an, das von der Hilfe in 32-Bit-Microsoft Windows-Betriebssystemen bereitgestellt wird (nur Entwurfszeit). |
| ZOrder | Platziert das Steuerelement an der Vorderseite oder rückseite der Z-Reihenfolge innerhalb der grafischen Ebene (nur Entwurfszeit). |
| Eigentum | Beschreibung |
|---|---|
| AutoRedraw-Eigenschaft | Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das InkPicture-Steuerelement neu gezeichnet wird, wenn das Fenster ungültig ist (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- | Dient zum Abrufen oder Festlegen der Hintergrundfarbe für das InkPicture -Steuerelement. 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 Sammlungsmodus, der bestimmt, ob Freihand, Gesten oder Freihandeingaben und Gesten erkannt werden, wenn der Benutzer schreibt. |
| 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 Entwurfszeit). |
| DefaultDrawingAttributes-Eigenschaft | Dient zum Abrufen oder Festlegen des Standard-InkDrawingAttributes Auflistung, 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 | Dient zum Abrufen oder Festlegen des Werts, der angibt, ob das InkPicture-Steuerelement die Freihandeingabe dynamisch rendert, während sie erfasst wird. |
| EditingMode- | Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob sich das InkPicture-Steuerelement im Freihandmodus, im Löschmodus oder im Auswahl-/Bearbeitungsmodus befindet. |
| Aktivierte | Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das InkPicture-Steuerelement auf vom Benutzer generierte 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. |
| EraserWidth- | Dient zum Abrufen oder Festlegen des Werts, der die Breite der Radiererstiftspitze angibt. |
| hWnd- | Ruft das Fensterhandle ab, an das das InkPicture -Steuerelement gebunden ist. (Nur Laufzeit) |
| Freihand- | Dient zum Abrufen oder Festlegen des InkDisp -Objekts, das dem InkPicture -Steuerelement zugeordnet ist (nur Laufzeit). |
| InkEnabled- | Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das InkPicture-Steuerelement Stifteingaben sammelt (In-Air-Pakete, Cursor in Bereichsereignissen usw.). |
| MarginX-Eigenschaft | Ruft den Rand der X-Achse um das Fensterrechteck in Bildschirmkoordinaten ab oder legt diese fest. |
| MarginY-Eigenschaft | Dient zum Abrufen oder Festlegen des Y-Achsenrands um das Fensterrechteck in Bildschirmkoordinaten. |
| MouseIcon-Eigenschaft | Ruft das aktuelle benutzerdefinierte Maussymbol ab oder legt es fest. |
| MousePointer-Eigenschaft | Dient zum Abrufen oder Festlegen eines Werts, der den Typ des Mauszeigers angibt, der angezeigt wird, wenn sich die Maus über einem bestimmten Teil des InkPicture-Steuerelements befindet. |
| Bild- | 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 verwendet wird (nur Laufzeit). |
| Auswahl- | Ruft die InkStrokes Auflistung ab, die derzeit innerhalb des InkPicture -Steuerelements ausgewählt ist (nur Laufzeit). |
| SizeMode- | Ruft ab oder legt fest, wie das Steuerelement die Bildplatzierung und Größenanpassung 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 Auswahlbenutzeroberflächen (Auswahlrahmenfeld und Auswahlziehpunkte) in hohem Kontrast gezeichnet werden, wenn sich das System im Modus "Hoher Kontrast" befindet. |
| Tablet-Eigenschaft | Ruft das IInkTablet- -Objekt ab, das das InkPicture -Steuerelement zurzeit zum Sammeln von Eingaben verwendet. |
Bemerkungen
Die Laufzeitbenutzeroberflä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 Freihandeingaben in Microsoft Windows 2000, Windows Server 2003, einer beliebigen Edition von Windows XP als Windows XP Tablet PC Edition und jeder Version von Windows Vista zu rendern. Sie können freihandeingaben, 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 ebenfalls 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 verwenden, die nicht Windows XP Tablet PC Edition 2005 ist, 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.
Persisted InkDisp objects can be loaded and displayed on all editions of Windows Vista and XP and on systems that have only the Windows XP Tablet PC Edition Software Development Kit (SDK) installiert. InkDisp--Objekte können nur in Text konvertiert werden (erkannt), 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 resultieren, überprüfen Sie das zurückgegebene HRESULT anhand des Fehlers.
Weitere Informationen zu Freihandsteuerelementen finden Sie unter Freihand-.
Informationen dazu, welche Threads bestimmte Ereignisse auslösen, finden Sie unter Threads, in denen ein Ereignisauslösen kann.
Um die Leistung Ihrer Anwendung zu verbessern, löschen Sie manuell ein InkPicture-Steuerelement, wenn es nicht mehr benötigt wird.
Anmerkung
Wenn ein InkPicture-Steuerelement mit einem anderen Steuerelement überlagert wird, z. B. ein GroupBox- 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-sein.
COM-Implementierung
Dieses Objekt implementiert die IInkPicture COM-Schnittstelle.