IInkStrokeDisp::SetPoints-Methode (msinkaut.h)
Legt die Punkte des IInkStrokeDisp mithilfe eines Arrays von X- und Y-Werten fest.
Syntax
HRESULT SetPoints(
[in] VARIANT Points,
[in, optional] long Index,
[in, optional] long Count,
[out, retval] long *NumberOfPointsSet
);
Parameter
[in] Points
Das Array von neuen Punkten, um die Punkte im Strich ab Index zu ersetzen. Dies ist ein VARIANT-Objekt, das ein Array von Long mit den Punkten enthält, die durch wechselnde Werte der Form x0, y0, x1, y1, x2, y2 usw. dargestellt werden.
Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.
[in, optional] Index
Optional. Der nullbasierte Index des ersten Punkts des zu ändernden Strichs. Der Standardwert ISC_FirstElement, der im ItemSelectionConstants-Enumerationstyp definiert ist, gibt an, dass der erste Punkt des Strichs geändert wird.
[in, optional] Count
Optional. Die Anzahl der Zu ändernden Punkte im Strich. Der Standardwert ISC_AllElements, der im ItemSelectionConstants-Enumerationstyp definiert ist, gibt an, dass alle Punkte im Strich geändert werden.
[out, retval] NumberOfPointsSet
Wenn diese Methode zurückgibt, enthält die tatsächliche Anzahl festgelegter Pakete.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Ungültiger Index (außerhalb des Bereichs) oder Punktparameters . War nicht im richtigen Format. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
Hinweise
Diese Methode ändert nicht die Anzahl der Punkte im Strich. Um die Anzahl der Punkte im Strich zu ändern, muss ein neuer Strich erstellt werden, oder der Strich muss geteilt werden.
Diese Methode ermöglicht nicht das Abschneiden des Strichs. Wenn das Punktearray weniger Punkte als der Strich enthält, werden die restlichen Punkte im Strich nicht geändert.
Diese Methode bietet keine Erweiterung des Strichs. Wenn das Punktearray mehr Punkte als der Strich enthält, werden die zusätzlichen Punkte nicht verwendet. Wenn die Anzahl die Anzahl der Punkte im Array überschreitet, wird nur die Anzahl der Punkte im Array geändert.
Um den Strich nach dem Aufrufen von SetPoints zu zeichnen, rufen Sie die InvalidateRect-Funktion auf.
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 |