Freigeben über


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

Siehe auch

IInkStrokeDisp-Schnittstelle

InkStrokes-Sammlung

IInkTablet-Schnittstelle