Compartilhar via


Estrutura PATHDATA (winddi.h)

A estrutura PATHDATA descreve todo ou parte de um subcaminho.

Sintaxe

typedef struct _PATHDATA {
  FLONG    flags;
  ULONG    count;
  POINTFIX *pptfx;
} PATHDATA, *PPATHDATA;

Membros

flags

Os sinalizadores que descrevem os dados retornados são definidos da seguinte maneira:

Valor Significado
PD_ALL Esse sinalizador é a combinação ORed dos outros sinalizadores nesta tabela. Ou seja, PD_ALL == PD_BEGINSUBPATH | PD_ENDSUBPATH | PD_RESETSTYLE | PD_CLOSEFIGURE | PD_BEZIERS.
PD_BEGINSUBPATH O primeiro ponto começa um novo subcaminho. Ele não está conectado ao subcaminho anterior. Se esse sinalizador não estiver definido, o ponto de partida para a primeira curva a ser desenhada a partir destes dados será o último ponto retornado na chamada anterior.
PD_BEZIERS Se definido, cada conjunto de três pontos de controle retornados para essa chamada descreve uma curva de Bezier. Se estiver claro, cada ponto de controle descreverá um segmento de linha. Um ponto de partida para qualquer tipo é explícito no início do subcaminho ou implícito como o ponto de extremidade da curva anterior.
PD_CLOSEFIGURE Esse bit só será definido se o registro terminar um subcaminho. Se definido, há um segmento de linha implícita conectando o último ponto do subcaminho com o primeiro ponto. Se um subcaminho fechado estiver sendo acarinhado, as junções serão usadas ao redor do caminho e não haverá limites finais. Se esse sinalizador não estiver definido, o subcaminho será considerado aberto, mesmo que o primeiro e o último pontos coincidam. Nesse caso, as tampas finais devem ser desenhadas. Esse sinalizador não é relevante para o preenchimento porque todos os subcaminhos são considerados fechados quando um caminho é preenchido.
PD_ENDSUBPATH O último ponto na matriz termina o subcaminho. Esse subcaminho pode ser aberto ou fechado dependendo do sinalizador PD_CLOSEFIGURE. Se houver mais dados a serem retornados no caminho, o próximo registro iniciará um novo subcaminho. Observe que um único registro pode começar e encerrar um subcaminho.
PD_RESETSTYLE Esse bit será definido somente se esse registro iniciar um novo subcaminho. Se definido, indica que o estado de estilo deve ser redefinido para zero no início do subcaminho. Se não estiver definido, o estado de estilo será definido pela estrutura LINEATTRS ou continuará do subcaminho anterior.

count

Especifica a contagem de estruturas POINTFIX apontadas por pptfx.

pptfx

Ponteiro para uma matriz de estruturas POINTFIX que definem os pontos de controle para as curvas. Essas estruturas não devem ser modificadas. Para obter uma descrição da estrutura POINTFIX, consulte Tipos de dados GDI.

Comentários

A estrutura PATHDATA descreve todo ou parte de um subcaminho. Por exemplo, uma chamada MoveTo por um aplicativo dentro de um caminho inicia um novo subcaminho.

Requisitos

Requisito Valor
Cabeçalho winddi.h (inclua Winddi.h)

Confira também

LINEATTRS

PATHOBJ_bEnum