Estrutura POLYTEXTA (wingdi.h)

Artigo
11/20/2024

A estrutura POLYTEXT descreve como a função PolyTextOut deve desenhar uma cadeia de caracteres de texto.

Sintaxe

typedef struct tagPOLYTEXTA {
  int    x;
  int    y;
  UINT   n;
  LPCSTR lpstr;
  UINT   uiFlags;
  RECT   rcl;
  int    *pdx;
} POLYTEXTA, *PPOLYTEXTA, *NPPOLYTEXTA, *LPPOLYTEXTA;

Membros

x

O ponto de referência horizontal da cadeia de caracteres. A cadeia de caracteres é alinhada a esse ponto usando o modo de alinhamento de texto atual.

y

O ponto de referência vertical da cadeia de caracteres. A cadeia de caracteres é alinhada a esse ponto usando o modo de alinhamento de texto atual.

n

O comprimento da cadeia de caracteres apontado por lpstr.

lpstr

Ponteiro para uma cadeia de caracteres de texto a ser desenhada pela função PolyTextOut. Essa cadeia de caracteres não precisa ser terminada em nulo, pois n especifica o comprimento da cadeia de caracteres.

uiFlags

Especifica se a cadeia de caracteres deve ser opaca ou recortada e se a cadeia de caracteres é acompanhada por uma matriz de valores de largura de caractere. Esse membro pode ser um ou mais dos valores a seguir.

Valor	Significado
ETO_OPAQUE	O retângulo para cada cadeia de caracteres deve ser opaco com a cor atual do plano de fundo.
ETO_CLIPPED	Cada cadeia de caracteres deve ser recortada ao retângulo especificado.

rcl

Uma estrutura de retângulo que contém as dimensões do retângulo de opaquing ou recorte. Esse membro será ignorado se nenhum dos ETO_OPAQUE nem o valor ETO_CLIPPED for especificado para o membro uiFlags.

pdx

Ponteiro para uma matriz que contém o valor de largura para cada caractere na cadeia de caracteres.

Observações

Nota

O cabeçalho wingdi.h define POLYTEXT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	wingdi.h (inclua Windows.h)

Consulte também

estruturas de fonte e texto

fontes e visão geral de texto

PolyTextOut

Compartilhar via