다음을 통해 공유


Graphics::D rawString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,constBrush*) 메서드(gdiplusgraphics.h)

Graphics::D rawString 메서드는 글꼴, 레이아웃 사각형 및 형식을 기반으로 문자열을 그립니다.

구문

Status DrawString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  const Brush        *brush
);

매개 변수

string

그릴 와이드 문자열에 대한 포인터입니다.

length

문자열 배열의 문자 수를 지정하는 정수입니다. 문자열이 null로 종료된 경우 length 매개 변수를 -1로 설정할 수 있습니다.

font

사용할 글꼴 특성(패밀리 이름, 크기 및 글꼴 스타일)을 지정하는 Font 개체에 대한 포인터입니다.

layoutRect

문자열을 바인딩하는 사각형에 대한 참조입니다.

stringFormat

문자열에 적용할 텍스트 레이아웃 정보 및 표시 조작을 지정하는 StringFormat 개체에 대한 포인터입니다.

brush

문자열을 채우는 데 사용되는 Brush 개체에 대한 포인터입니다.

반환 값

메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

GDI+는 TrueType 윤곽선이 없는 PostScript 글꼴 또는 OpenType 글꼴을 지원하지 않습니다.

GDI+ API를 사용하는 경우 애플리케이션이 신뢰할 수 없는 원본에서 임의의 글꼴을 다운로드하도록 허용해서는 안 됩니다. 운영 체제에는 설치된 모든 글꼴을 신뢰할 수 있도록 높은 권한이 필요합니다.

예제

다음 예제에서는 지정된 서식을 사용하여 레이아웃 사각형에 문자열을 그립니다.

VOID Example_DrawString(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a string.
   WCHAR string[] = L"Sample Text";
   
   // Initialize arguments.
   Font myFont(L"Arial", 16);
   RectF layoutRect(0.0f, 0.0f, 200.0f, 50.0f);
   StringFormat format;
   format.SetAlignment(StringAlignmentCenter);
   SolidBrush blackBrush(Color(255, 0, 0, 0));

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   layoutRect,
   &format,
   &blackBrush);

   // Draw layoutRect.
   graphics.DrawRectangle(&Pen(Color::Black, 3), layoutRect);
}

요구 사항

   
머리글 gdiplusgraphics.h

추가 정보

그래픽

글꼴

RectF

StringFormat