Método Graphics::MeasureString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,RectF*,INT*,INT*) (gdiplusgraphics.h)
O método Graphics::MeasureString mede a extensão da cadeia de caracteres no retângulo de fonte, formato e layout especificados.
Sintaxe
Status MeasureString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
RectF *boundingBox,
INT *codepointsFitted,
INT *linesFilled
);
Parâmetros
string
Ponteiro para uma cadeia de caracteres largos a ser medida.
Importante Para idiomas bidirecionais, como árabe, o comprimento da cadeia de caracteres não deve exceder 2046 caracteres.
length
Inteiro que especifica o número de caracteres na matriz de cadeia de caracteres . O parâmetro length poderá ser definido como -1 se a cadeia de caracteres for terminada em nulo.
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.
layoutRect
Referência ao retângulo que vincula a cadeia de caracteres.
stringFormat
Ponteiro para um objeto StringFormat que especifica as informações de layout, como alinhamento, corte, paradas de tabulação e assim por diante.
boundingBox
Ponteiro para um objeto RectF que recebe o retângulo que associa a cadeia de caracteres.
codepointsFitted
Opcional. Ponteiro para um INT que recebe o número de caracteres que realmente se encaixam no retângulo de layout. O valor padrão é um ponteiro NULL .
linesFilled
Opcional. Ponteiro para um INT que recebe o número de linhas que se encaixam no retângulo de layout. O valor padrão é um ponteiro NULL .
Retornar valor
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
Exemplos
O exemplo a seguir mede o tamanho de uma cadeia de caracteres e desenha um retângulo que representa esse tamanho.
VOID Example_MeasureString2(HDC hdc)
{
Graphics graphics(hdc);
// Set up the string.
WCHAR string[] = L"Measure Text";
Font font(L"Arial", 16);
RectF layoutRect(0.0f, 0.0f, 100.0f, 50.0f);
StringFormat format;
format.SetAlignment(StringAlignmentFar);
RectF boundRect;
// Measure the string.
graphics.MeasureString(string, 12, &font, layoutRect, &format, &boundRect);
// Draw a rectangle that represents the size of the string.
graphics.DrawRectangle(&Pen(Color(255, 0, 0, 0)), boundRect);
}
Requisitos
Cabeçalho | gdiplusgraphics.h |