InkDisp-Klasse

Stellt die gesammelten Freihandstriche innerhalb eines Freihandraums dar.

InkDisp verfügt über folgende Membertypen:

• Ereignisse
• Schnittstellen
• Methoden
• Eigenschaften

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	msinkaut.h (erfordert auch Msinkaut_i.c)
Bibliothek	InkObj.dll

Siehe auch

IInkStrokeDisp-Schnittstelle

InkStrokes-Sammlung

IInkTablet-Schnittstelle