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

El método Graphics::MeasureString mide la extensión de la cadena en el rectángulo de fuente, formato y diseño especificados.

Sintaxis

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

Puntero a una cadena de caracteres anchos que se va a medir.

Importante En el caso de los idiomas bidireccionales, como el árabe, la longitud de la cadena no debe superar los 2046 caracteres.

length

Entero que especifica el número de caracteres de la matriz de cadenas . El parámetro length se puede establecer en -1 si la cadena termina en null.

font

Puntero a un objeto Font que especifica el nombre de familia, el tamaño y el estilo de la fuente que se va a aplicar a la cadena.

layoutRect

Referencia al rectángulo que enlaza la cadena.

stringFormat

Puntero a un objeto StringFormat que especifica la información de diseño, como la alineación, el recorte, las tabulaciones, etc.

boundingBox

Puntero a un objeto RectF que recibe el rectángulo que enlaza la cadena.

codepointsFitted

Opcional. Puntero a un INT que recibe el número de caracteres que encajan realmente en el rectángulo de diseño. El valor predeterminado es un puntero NULL .

linesFilled

Opcional. Puntero a un INT que recibe el número de líneas que caben en el rectángulo de diseño. El valor predeterminado es un puntero NULL .

Valor devuelto

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Observaciones

Ejemplos

En el ejemplo siguiente se mide el tamaño de una cadena y, a continuación, se dibuja un rectángulo que representa ese tamaño.

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

Encabezado	gdiplusgraphics.h

Consulte también

Métodos DrawString

Fuente

Elementos gráficos

RectF

StringFormat