Compartilhar via


Método Graphics::D rawDriverString (gdiplusgraphics.h)

O método Graphics::D rawDriverString desenha caracteres nas posições especificadas. O método fornece ao cliente controle total sobre a aparência do texto. O método pressupõe que o cliente já configurou o formato e o layout a serem aplicados.

Sintaxe

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

Parâmetros

[in] text

Tipo: const UINT16*

Ponteiro para uma matriz de valores de 16 bits. Se o sinalizador DriverStringOptionsCmapLookup estiver definido, cada valor especificará um caractere Unicode a ser exibido. Caso contrário, cada valor especifica um índice para um glifo de fonte que define um caractere a ser exibido.

[in] length

Tipo: INT

Inteiro que especifica o número de valores na matriz de texto . O parâmetro length poderá ser definido como –1 se a cadeia de caracteres for terminada em nulo.

[in] font

Tipo: const Font*

Ponteiro para um objeto Font que especifica o nome da família, o tamanho e o estilo da fonte a ser aplicada à cadeia de caracteres.

[in] brush

Tipo: const Brush*

Ponteiro para um objeto Brush usado para preencher a cadeia de caracteres.

[in] positions

Tipo: const PointF*

Se o sinalizador DriverStringOptionsRealizedAdvance estiver definido, positions será um ponteiro para um objeto PointF que especifica a posição do primeiro glifo. Caso contrário, positions é uma matriz de objetos PointF , cada um dos quais especifica a origem de um glifo individual.

[in] flags

Tipo: INT

Inteiro que especifica as opções para a aparência da cadeia de caracteres. Esse valor deve ser um elemento da enumeração DriverStringOptions ou o resultado de um OR bit a bit aplicado a dois ou mais desses elementos.

[in] matrix

Tipo: const Matrix*

Ponteiro para um objeto Matrix que especifica a matriz de transformação a ser aplicada a cada valor na matriz de texto .

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Esse método não dá suporte ao tratamento de scripts complexos e pressupõe que o cliente configurou todo o layout de texto de alguma outra maneira. Esse método é útil para criar itens de menu desenhados pelo proprietário. O cliente deve usar o método Métodos DrawString para fins gerais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca Gdiplus.lib
DLL Gdiplus.dll

Confira também

Pincel

Métodos DrawString

DriverStringOptions

Fonte

Elementos gráficos

Graphics::MeasureDriverString

Matriz

Pointf