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 |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Das InkDisp-Objekt ist nicht registriert. |
|
Ungültiges Cliprechteck. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
|
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 |