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

아티클
07/16/2024

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

통사론

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

매개 변수

string

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

length

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

family

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

style

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

emSize

문자열 문자의 em 크기를 세계 단위로 지정하는 실수입니다.

origin

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

format

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

반환 값

유형:상태

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

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

발언

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, 
      PointF(50.0f, 50.0f),
      NULL);

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