Método Graphics::MeasureString(constWCHAR,INT,constFont,constRectF&,constStringFormat,RectF,INT,INT) (gdiplusgraphics.h)

Artigo
08/24/2023

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);
}