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 |