다음을 통해 공유


GraphicsPath::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constRect&,constStringFormat*) 메서드(gdipluspath.h)

GraphicsPath::AddString 메서드는 문자열의 윤곽선을 이 경로에 추가합니다.

구문

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Rect &       layoutRect,
  [in]      const StringFormat *format
);

매개 변수

[in] string

형식: const WCHAR*

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

[in] length

형식: INT

표시할 문자 수를 지정하는 정수입니다. 문자열 매개 변수가 NULL로 끝나는 문자열을 가리키는 경우 이 매개 변수를 –1로 설정할 수 있습니다.

[in] family

형식: const FontFamily*

문자열의 글꼴 패밀리를 지정하는 FontFamily 개체에 대한 포인터입니다.

[in] style

형식: INT

서체의 스타일을 지정하는 정수입니다. 이 값은 FontStyle 열거형의 요소이거나 두 개 이상의 요소에 적용되는 비트 OR 의 결과여야 합니다. 예를 들어 는 FontStyleBold | FontStyleUnderline | FontStyleStrikeout 스타일을 세 가지 스타일의 조합으로 설정합니다.

[in] emSize

형식: REAL

문자열 문자의 em 크기(월드 단위)를 지정하는 실수입니다.

[in, ref] layoutRect

형식: const Rect

세계 단위에서 문자열의 경계 사각형을 지정하는 Rect 개체에 대한 참조입니다.

[in] format

형식: const StringFormat*

문자열에 대한 레이아웃 정보(맞춤, 트리밍, 탭 중지 등)를 지정하는 StringFormat 개체에 대한 포인터입니다.

반환 값

형식: 상태

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

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

설명

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

예제

다음 예제에서는 GraphicsPath 개체 경로를 만들고 , NULL로 끝나는 문자열을 경로에 추가한 다음, 경로를 그립니다.

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      Rect(50, 50, 150, 100),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 gdipluspath.h(Gdiplus.h 포함)
라이브러리 Gdiplus.lib
DLL Gdiplus.dll

추가 정보

AddString 메서드

지역을 사용하여 클리핑

경로 구성 및 그리기

경로 그라데이션 만들기

글꼴

FontFamily

FontStyle

Graphicspath

Rect

StringFormat

텍스트 및 글꼴 사용