Метод IXpsOMGeometryFigure::GetSegmentStrokes (xpsobjectmodel.h)

Статья
08/28/2023

Возвращает определения росчерка для сегментов фигуры.

Синтаксис

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

Параметры

[in, out] segmentCount

Размер массива, на который ссылается segmentStrokes. Этот параметр не должен иметь значение NULL.

Если метод возвращает успешно, segmentCount будет содержать количество элементов, возвращаемых в массиве, на который ссылается segmentStrokes.

Если при вызове метода segmentStrokes имеет значение NULL , значение segmentCount должно быть равно нулю.

Если в segmentStrokes возвращается указатель NULL, значение segmentCount будет содержать требуемый размер буфера, указанный как количество элементов.

[in, out] segmentStrokes

Массив с таким же количеством элементов, как указано в segmentCount. Если вызывающий объект требует, чтобы этот метод возвращал только требуемый размер буфера, присвойте этому параметру значение NULL.

Если массив достаточно велик, этот метод копирует значения росчерка сегмента в массив и возвращает в segmentCount количество скопированных значений росчерка сегмента. Если segmentData имеет значение NULL или ссылается на недостаточно большой буфер, возвращается указатель NULL , данные не копируются, а segmentCount будет содержать требуемый размер буфера, указанный в качестве количества элементов.

В следующей таблице показаны возможные значения элемента в массиве, на который ссылается segmentStrokes.

Значение	Значение
ИСТИННЫЙ	Сегмент обводится.
ЛОЖНЫХ	Сегмент не обводится.

Возвращаемое значение

Если метод завершается успешно, он возвращает S_OK; в противном случае возвращается код ошибки HRESULT .

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	segmentCount имеет значение NULL.
ERROR_MORE_DATA	segmentStrokes имеет значение NULL или ссылается на буфер, который недостаточно велик для получения данных росчерка сегмента. segmentCount содержит необходимое количество элементов.

Требования


Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	xpsobjectmodel.h

См. также раздел

IXpsOMGeometryFigure

XPS

Поделиться через