Método Graphics::MeasureDriverString (gdiplusgraphics.h)
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 |