ID2D1RenderTarget::D rawTextLayout 메서드(d2d1.h)

지정된 IDWriteTextLayout 개체에서 설명하는 서식이 지정된 텍스트를 그립니다.

구문

void DrawTextLayout(
       D2D1_POINT_2F          origin,
  [in] IDWriteTextLayout      *textLayout,
  [in] ID2D1Brush             *defaultFillBrush,
       D2D1_DRAW_TEXT_OPTIONS options
);

매개 변수

origin

형식: D2D1_POINT_2F

textLayout에서 설명하는 텍스트의 왼쪽 위 모서리가 그려지는 디바이스 독립적 픽셀에 설명된 점입니다.

[in] textLayout

형식: IDWriteTextLayout*

그릴 서식이 지정된 텍스트입니다. ID2D1Resource에서 상속되지 않는 그리기 효과는 무시됩니다. 브러시가 아닌 ID2D1Resource 에서 상속되는 그리기 효과가 있는 경우 이 메서드가 실패하고 렌더링 대상이 오류 상태에 놓입니다.

[in] defaultFillBrush

형식: ID2D1Brush*

textLayout에서 그리기 효과로 연결된 브러시가 없는 텍스트를 그리는 데 사용되는 브러시입니다(IDWriteTextLayout::SetDrawingEffect 메서드로 지정됨).

options

형식: D2D1_DRAW_TEXT_OPTIONS

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

반환 값

없음

설명

동일한 텍스트를 반복해서 그릴 때는 텍스트의 서식을 지정할 필요가 없고 각 호출을 통해 레이아웃이 처리되므로 DrawTextLayout 메서드를 사용하는 것이 DrawText 메서드를 사용하는 것보다 더 효율적입니다.

이 메서드는 실패할 경우 오류 코드를 반환하지 않습니다. 그리기 작업(예: DrawTextLayout)이 실패했는지 여부를 확인하려면 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

추가 정보

ID2D1RenderTarget

텍스트 서식 및 레이아웃