Método IXpsOMGeometryFigure::GetSegmentStrokes (xpsobjectmodel.h)

Artigo
12/22/2023

Obtém definições de traço para os segmentos da figura.

Sintaxe

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

Parâmetros

[in, out] segmentCount

O tamanho da matriz referenciada por segmentStrokes. Esse parâmetro não deve ser NULL.

Se o método retornar com êxito, segmentCount conterá o número de elementos retornados na matriz referenciada por segmentStrokes.

Se segmentStrokes for NULL quando o método for chamado, segmentCount deverá ser definido como zero.

Se um ponteiro NULL for retornado em segmentStrokes, o valor de segmentCount conterá o tamanho do buffer necessário, especificado como o número de elementos.

[in, out] segmentStrokes

Uma matriz que tem o mesmo número de elementos especificado em segmentCount. Se o chamador exigir que esse método retorne apenas o tamanho do buffer necessário, defina esse valor como NULL.

Se a matriz for grande o suficiente, esse método copiará os valores de traço do segmento para a matriz e retornará, em segmentCount, o número de valores de traço de segmento copiados. Se segmentData for NULL ou fizer referência a um buffer que não é grande o suficiente, um ponteiro NULL será retornado, nenhum dado será copiado e segmentCount conterá o tamanho do buffer necessário especificado como o número de elementos.

A tabela a seguir mostra os possíveis valores de um elemento na matriz referenciada por segmentStrokes.

Valor	Significado
VERDADE	O segmento é traçado.
FALSE	O segmento não é traçado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	segmentCount é NULL.
ERROR_MORE_DATA	segmentStrokes é NULL ou faz referência a um buffer que não é grande o suficiente para receber os dados de traço do segmento. segmentCount contém o número necessário de elementos.

Requisitos


Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h

Confira também

IXpsOMGeometryFigure

Especificação de Papel XML

Compartilhar via