Método Graphics::MeasureDriverString (gdiplusgraphics.h)

Artigo
02/29/2024

O método Graphics::MeasureDriverString mede a caixa delimitadora para os caracteres especificados e suas posições correspondentes.

Sintaxe

Status MeasureDriverString(
  [in]  const UINT16 *text,
  [in]  INT          length,
  [in]  const Font   *font,
  [in]  const PointF *positions,
  [in]  INT          flags,
  [in]  const Matrix *matrix,
  [out] RectF        *boundingBox
);

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] 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 .

[out] boundingBox

Tipo: RectF*

Ponteiro para um objeto RectF que recebe o retângulo que associa a cadeia de caracteres.

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 .

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