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

아티클
08/24/2023

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

구문

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Point &      origin,
  [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] origin

형식: const Point

세계 단위에서 문자열의 위치를 지정하는 Point 개체에 대한 참조입니다.

[in] format

형식: const StringFormat*

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

반환 값

형식: 상태

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

메서드가 실패하면 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, 
      Point(50, 50),
      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