Estrutura POLYTEXTA (wingdi.h)

  • Artigo

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 para a 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 para a 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 apontada 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 da tela de fundo atual.
ETO_CLIPPED Cada cadeia de caracteres deve ser recortada em seu retângulo especificado.

rcl

Uma estrutura de retângulo que contém as dimensões do retângulo 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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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

Confira também

Estruturas de fonte e texto

Visão geral de fontes e texto

PolyTextOut