Freigeben über


IXpsOMGeometryFigure::GetSegmentStrokes-Methode (xpsobjectmodel.h)

Ruft Strichdefinitionen für die Segmente der Abbildung ab.

Syntax

HRESULT GetSegmentStrokes(
  [in, out] UINT32 *segmentCount,
  [in, out] BOOL   *segmentStrokes
);

Die Parameter

[in, out] segmentCount

Die Größe des Arrays, auf das durch SegmentStrokes verwiesen wird. Dieser Parameter darf nicht NULL sein.

Wenn die Methode erfolgreich zurückgegeben wird, enthält segmentCount die Anzahl der Elemente, die im Array zurückgegeben werden, auf das segmentStrokes verwiesen wird.

Wenn segmentStrokesNULL ist, wenn die Methode aufgerufen wird, muss segmentCount auf Null festgelegt werden.

Wenn ein NULL-Zeiger in segmentStrokes zurückgegeben wird, enthält der Wert von segmentCount die erforderliche Puffergröße, die als Anzahl von Elementen angegeben wird.

[in, out] segmentStrokes

Ein Array, das dieselbe Anzahl von Elementen wie in segmentCount angegeben hat. Wenn der Aufrufer erfordert, dass diese Methode nur die erforderliche Puffergröße zurückgibt, legen Sie diesen Wert auf NULL fest.

Wenn das Array groß genug ist, kopiert diese Methode die Segmentstrichwerte in das Array und gibt in segmentCount die Anzahl der kopierten Segmentstrichwerte zurück. Wenn segmentDataNULL ist oder auf einen Puffer verweist, der nicht groß genug ist, wird ein NULL-Zeiger zurückgegeben, es werden keine Daten kopiert, und segmentCount enthält die erforderliche Puffergröße, die als Anzahl von Elementen angegeben ist.

Die folgende Tabelle zeigt die möglichen Werte eines Elements im Array, auf das durch SegmentStrokes verwiesen wird.

Wert Bedeutung
TRUE
Das Segment wird gestrichelt.
FALSE
Das Segment wird nicht gestrichelt.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben; andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode Description
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_POINTER
segmentCount ist NULL.
ERROR_MORE_DATA
segmentStrokes ist NULL oder verweist auf einen Puffer, der nicht groß genug ist, um die Segmentstrichdaten zu empfangen. segmentCount enthält die erforderliche Anzahl von Elementen.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header xpsobjectmodel.h

Siehe auch

IXpsOMGeometryFigure

XML Paper Specification