Função EngStrokePath (winddi.h)

A função EngStrokePath solicita que o GDI traçou um caminho especificado.

Sintaxe

ENGAPI BOOL EngStrokePath(
       SURFOBJ   *pso,
       PATHOBJ   *ppo,
       CLIPOBJ   *pco,
       XFORMOBJ  *pxo,
       BRUSHOBJ  *pbo,
       POINTL    *pptlBrushOrg,
  [in] LINEATTRS *plineattrs,
  [in] MIX       mix
);

Parâmetros

pso

Ponteiro para uma estrutura SURFOBJ que descreve a superfície na qual desenhar.

ppo

Ponteiro para uma estrutura PATHOBJ . As rotinas de serviço PATHOBJ_Xxx são fornecidas para enumerar as linhas, as curvas de Bézier e outros dados que compõem o caminho. Isso indica o que deve ser desenhado.

pco

Ponteiro para uma estrutura CLIPOBJ . As rotinas de serviço CLIPOBJ_Xxx são fornecidas para enumerar a região de clipe como um conjunto de retângulos. Opcionalmente, todas as linhas no caminho podem ser enumeradas previamente por esse CLIPOBJ. Isso significa que os drivers podem ter todos os cálculos de recorte de linha feitos para eles.

pxo

Ponteiro para uma estrutura XFORMOBJ . Isso é necessário somente quando uma linha larga geométrica deve ser desenhada. Ele especifica a transformação que converte as coordenadas do mundo em coordenadas do dispositivo. Isso é necessário porque o caminho é fornecido em coordenadas do dispositivo, mas uma linha larga geométrica é realmente ampliada em coordenadas mundiais.

O driver pode usar as rotinas de serviço XFORMOBJ_Xxx para determinar a transformação.

pbo

Ponteiro para uma estrutura BRUSHOBJ que especifica o pincel a ser usado ao desenhar o caminho.

pptlBrushOrg

Ponteiro para uma estrutura POINTL que contém a origem do pincel usada para alinhar o padrão de pincel no dispositivo.

[in] plineattrs

Ponteiro para uma estrutura LINEATTRS . Observe que o membro elStyleState dessa estrutura deve ser atualizado como parte dessa função se a linha for estilizada. Observe também que o membro ptlLastPel da mesma estrutura deverá ser atualizado se uma linha cosmética de largura de pixel único estiver sendo desenhada.

[in] mix

Especifica como combinar o pincel com o destino.

Valor retornado

O valor retornado será TRUE se o GDI traços o caminho. Se o driver deve acariciá-lo, o valor retornado será FALSE e nenhum erro será registrado. Se a GDI encontrar um erro, o valor retornado será DDI_ERROR e um código de erro será registrado.

Comentários

O modo de combinação define como o padrão de entrada deve ser misturado com os dados que já estão na superfície do dispositivo. O tipo de dados MIX consiste em dois valores ROP2 empacotados em um único ULONG. O byte de baixa ordem define a operação de varredura em primeiro plano; o próximo byte define a operação de varredura em segundo plano. Para obter mais informações sobre códigos de operação de varredura, consulte a documentação do SDK do Microsoft Windows.

Requisitos

Confira também

CLIPOBJ

DrvStrokePath

LINEATTRS

PATHOBJ

SURFOBJ

XFORMOBJ