Graphics::MeasureString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,RectF*,INT*,INT*) 메서드(gdiplusgraphics.h)
Graphics::MeasureString 메서드는 지정된 글꼴, 형식 및 레이아웃 사각형에서 문자열의 범위를 측정합니다.
구문
Status MeasureString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
RectF *boundingBox,
INT *codepointsFitted,
INT *linesFilled
);
매개 변수
string
측정할 와이드 문자열에 대한 포인터입니다.
중요 아랍어와 같은 양방향 언어의 경우 문자열 길이가 2046자를 초과하면 안 됩니다.
length
문자열 배열의 문자 수를 지정하는 정수입니다. 문자열이 null로 종료된 경우 length 매개 변수를 -1로 설정할 수 있습니다.
font
문자열에 적용할 글 꼴의 패밀리 이름, 크기 및 스타일을 지정하는 Font 개체에 대한 포인터입니다.
layoutRect
문자열을 바인딩하는 사각형에 대한 참조입니다.
stringFormat
맞춤, 트리밍, 탭 중지 등과 같은 레이아웃 정보를 지정하는 StringFormat 개체에 대한 포인터입니다.
boundingBox
문자열을 바인딩하는 사각형을 수신하는 RectF 개체에 대한 포인터입니다.
codepointsFitted
선택 사항입니다. 실제로 레이아웃 사각형에 맞는 문자 수를 수신하는 INT 에 대한 포인터입니다. 기본값은 NULL 포인터입니다.
linesFilled
선택 사항입니다. 레이아웃 사각형에 맞는 줄 수를 받는 INT 에 대한 포인터입니다. 기본값은 NULL 포인터입니다.
반환 값
메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
설명
예제
다음 예제에서는 문자열의 크기를 측정한 다음 해당 크기를 나타내는 사각형을 그립니다.
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);
}
요구 사항
| 머리글 | gdiplusgraphics.h |