InkDisp-Klasse
Stellt die gesammelten Freihandstriche innerhalb eines Freihandraums dar.
InkDisp verfügt über folgende Membertypen:
Ereignisse
Die InkDisp-Klasse verfügt über diese Ereignisse.
| Ereignis | BESCHREIBUNG |
|---|---|
| InkAdded | Tritt auf, wenn dem InkDisp-Objekt ein Strich hinzugefügt wird. |
| InkDeleted | Tritt auf, wenn ein Strich aus dem InkDisp-Objekt gelöscht wird. |
Schnittstellen
Die InkDisp-Klasse definiert diese Schnittstellen.
| Schnittstelle | BESCHREIBUNG |
|---|---|
| IInkDisp | Dieses Objekt implementiert die IInkDisp-COM-Schnittstelle . |
Methoden
Die InkDisp-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| AddStrokesAtRectangle | Fügt eine Strichauflistung am angegebenen Rechteck in das InkDisp-Objekt ein. |
| Canpaste | Gibt an, ob das IDataObject in ein InkDisp-Objekt konvertiert werden kann. |
| Clip | Entfernt Teile eines Strichs oder einer Auflistung von Strichen, die sich außerhalb eines Rechtecks befinden. |
| Clipboardcopy | Kopiert die InkStrokes-Auflistung in die Zwischenablage. |
| ClipboardCopyWithRectangle | Kopiert die IInkStrokeDisp-Objekte , die im bekannten Rechteck enthalten sind, in die Zwischenablage. |
| ClipboardPaste | Kopiert das IDataObject aus der Zwischenablage in das InkDisp-Objekt . |
| Klon | Erstellt ein doppeltes InkDisp-Objekt . |
| Ink.createstroke | Erstellt einen Strich aus Punkt- oder Paketdaten. |
| CreateStrokes | Erstellt eine InkStrokes-Auflistung für dieses InkDisp-Objekt . |
| DeleteStroke | Löscht einen Strich aus dem InkDisp-Objekt . |
| DeleteStrokes | Löscht Striche aus dem InkDisp-Objekt . |
| ExtractStrokes-Methode | Extrahiert Striche aus dem InkDisp-Objekt und gibt ein neues InkDisp-Objekt zurück, das die extrahierten Striche enthält. |
| ExtractWithRectangle-Methode | Schneidet oder kopiert Striche aus einem vorhandenen InkDisp Class-Objekt und fügt sie in ein neues InkDisp Class-Objekt ein, indem das bekannte Rechteck verwendet wird, um zu bestimmen, welche Striche extrahiert werden sollen. |
| Getboundingbox | Ruft das begrenzungsfeld aller Striche im InkDisp-Objekt ab. |
| HitTestCircle | Ruft die InkStrokes-Auflistung ab, die sich entweder vollständig innerhalb oder durch einen bekannten Kreis überschneiden. |
| HitTestWithLasso | Ruft die Striche innerhalb eines Polylinienauswahlbereichs ab. |
| HitTestWithRectangle | Ruft die Striche ab, die in einem angegebenen Rechteck enthalten sind. |
| Laden | Füllt ein neues InkDisp-Objekt mit bekannten Binärdaten auf. |
| Ink.nearestpoint | Ruft das IInkStrokeDisp innerhalb des InkDisp-Objekts ab, das einem bekannten Punkt am nächsten ist, und stellt optional zusätzliche Informationen bereit. |
| Speichern | Konvertiert die Freihandeingabe in ein angegebenes Format und gibt die Binärdaten zurück. |
Eigenschaften
Die InkDisp-Klasse verfügt über diese Eigenschaften.
| Eigenschaft | Zugriffstyp | BESCHREIBUNG |
|---|---|---|
|
Customstrokes |
Schreibgeschützt |
Ruft die IInkCustomStrokes-Auflistung ab, die mit der Freihand beibehalten werden soll. |
|
Schmutzig |
Lesen/Schreiben |
Ruft den Wert ab, der angibt, ob ein InkDisp-Objekt seit dem letzten Speichern der Freihandeingabe geändert wurde, oder legt diesen fest. |
|
ExtendedProperties |
Schreibgeschützt |
Ruft die Auflistung von anwendungsdefinierten Daten ab. |
|
Striche |
Schreibgeschützt |
Ruft die InkStrokes-Auflistung ab, die im InkDisp-Objekt enthalten ist. |
Bemerkungen
Dieses Objekt kann instanziiert werden, indem die CoCreateInstance-Methode in C++ aufgerufen wird.
Hinweis
Die erste Instanziierung dieses Objekts bewirkt, dass auch GDI+ instanziiert wird. Ein Nebeneffekt ist, dass GDI+ immer wieder instanziiert wird, wenn Sie ein einzelnes Freihandobjekt in einer Schleife verwenden und es innerhalb der Schleife erstellen und zerstören. Dies kann zu einer Leistungsminderung in Ihrer Anwendung führen. Um dies zu verhindern, behalten Sie eine einzelne instance eines Freihandobjekts jederzeit bei, während Ihre Anwendung Freihandeingaben verwendet.
Ein InkDisp-Objekt ist ein Container mit Strichdaten (Punkt). Die Strichdaten oder die vom Stift gesammelten Punkte werden in ein InkDisp-Objekt eingefügt. Die Strokes-Eigenschaft enthält die Daten für alle Striche im InkDisp-Objekt .
Das InkCollector-Objekt , das InkOverlay-Objekt und das InkPicture-Steuerelement sammeln Punkte vom Eingabegerät und fügt sie in ein InkDisp-Objekt ein. Diese Objekte fungieren im Wesentlichen als Quelle, die Freihand in ein oder mehrere verschiedene InkDisp-Objekte verteilt, die als Container fungieren, die die verteilte Freihand enthalten.
Der Freihandbereich ist ein virtueller Koordinatenraum, dem die Koordinaten des Tablet-Kontexts zugeordnet werden. Dieser Bereich ist an ein HIMETRIC-Koordinatensystem festgelegt. In Freihandraumkoordinaten entspricht eine Verschiebung von 0 zu 1 einer HIMETRIC-Einheit. Diese Zuordnung erleichtert das Verknüpfen mehrerer InkDisp-Objekte .
Das InkRenderer-Objekt verwaltet die Zuordnungen zwischen Freihand und dem Anzeigefenster.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| Bibliothek |
|