ID2D1RenderTarget::D rawText(constWCHAR,UINT32,IDWriteTextFormat,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) 메서드(d2d1.h)

아티클
01/10/2024

IDWriteTextFormat 개체에서 제공하는 서식 정보를 사용하여 지정된 텍스트를 그립니다.

구문

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

매개 변수

[in] string

형식: WCHAR*

그릴 유니코드 문자 배열에 대한 포인터입니다.

stringLength

형식: UINT

문자열의 문자 수입니다.

[in] textFormat

형식: IDWriteTextFormat*

글꼴, 글꼴 크기 및 흐름 방향과 같이 그릴 텍스트의 서식 세부 정보를 설명하는 개체입니다.

[ref] layoutRect

형식: const D2D1_RECT_F

텍스트를 그릴 영역의 크기와 위치입니다.

[in] defaultFillBrush

형식: ID2D1Brush*

텍스트를 그리는 데 사용되는 브러시입니다.

options

형식: D2D1_DRAW_TEXT_OPTIONS

텍스트를 픽셀 경계에 맞춰야 하는지 여부와 텍스트를 레이아웃 사각형으로 클리핑해야 하는지 여부를 나타내는 값입니다. 기본값은 D2D1_DRAW_TEXT_OPTIONS_NONE, 이는 텍스트를 픽셀 경계에 맞춰야 하며 레이아웃 사각형으로 잘려서는 안 됨을 나타냅니다.

measuringMode

형식: DWRITE_MEASURING_MODE

문자 모양 메트릭이 서식을 지정할 때 텍스트를 측정하는 데 사용되는 방식을 나타내는 값입니다. 기본값은 DWRITE_MEASURING_MODE_NATURAL.

반환 값

없음

설명

IDWriteTextFormat 개체를 만들려면 IDWriteFactory를 만들고 CreateTextFormat 메서드를 호출합니다.

이 메서드는 실패할 경우 오류 코드를 반환하지 않습니다. 그리기 작업(예: DrawText)이 실패했는지 여부를 확인하려면 ID2D1RenderTarget::EndDraw 또는 ID2D1RenderTarget::Flush 메서드에서 반환된 결과를 검사.

예제

예제는 방법: 텍스트 그리기를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	d2d1.h
라이브러리	D2d1.lib
DLL	D2d1.dll