Freigeben über


IInkStrokes::Clip-Methode (msinkaut.h)

Entfernt Teile eines IInkStrokeDisp-Objekts oder einer InkStrokes-Auflistung , die sich außerhalb eines Rechtecks befinden.

Syntax

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Parameter

[in] Rectangle

Gibt das Rechteck an, außerhalb dessen der Strich oder die Striche abgeschnitten werden. Das Rechteck wird in Freihandraumkoordinaten angegeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
REGDB_CLASSNOTREG
Das InkDisp-Objekt ist nicht registriert.
E_INVALIDARG
Ungültiges Cliprechteck.
E_INK_EXCEPTION
Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Bei einem InkDisp-Objekt werden alle Striche, die durch das Rechteck überschnitten sind, an den Schnittpunkten aufgeteilt. Alle Teile von Strichen außerhalb des Rechtecks werden aus dem InkDisp-Objekt entfernt. Die -Methode kann einem Strich an der Stelle, an der der Strich das Rechteck überschneidet, neue Punkte hinzufügen. Nachdem Sie die Clip-Methode für ein InkDisp-Objekt aufgerufen haben, sind die IDs der Striche in der Strichauflistung des InkDisp-Objekts garantiert eindeutig, aber nicht garantiert, dass sie andere Informationen beibehalten.

Bei dieser Methode wird die Stiftbreite beim Beschneiden nicht berücksichtigt. Es schneidet nur die tatsächlichen Freihand- oder Strichdaten ab.

Für ein IInkStrokeDisp-Objekt oder eine InkStrokes-Auflistung aktualisiert die Clip-Methode das übergeordnete InkDisp-Objekt . Wenn Freihand aus einem InkDisp-Objekt entfernt wird, werden alle für dieses InkDisp-Objekt definierten IInkStrokeDisp-Objekte oder InkStrokes-Auflistungen möglicherweise ungültig.

Weitere Informationen zu Freihanddaten finden Sie unter Freihanddaten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile msinkaut.h
Bibliothek InkObj.dll

Weitere Informationen

HitTest(Rectangle, Single)-Methode

IInkStrokes

InkRectangle-Klasse

InkStrokes-Auflistung