IDWriteFactory::CreateGdiCompatibleTextLayout 메서드(dwrite.h)

문자열, 형식 및 관련 제약 조건을 사용하고 특정 디스플레이 해상도 및 측정 모드에 대한 형식이 지정된 결과를 나타내는 개체를 생성합니다.

구문

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

매개 변수

[in] string

형식: const WCHAR*

새 IDWriteTextLayout 개체를 만들 문자열을 포함하는 문자 배열입니다. 이 배열은 stringLength 길이여야 하며 포함된 NULL 문자를 포함할 수 있습니다.

stringLength

형식: UINT32

문자열의 길이(문자 수)입니다.

textFormat

형식: IDWriteTextFormat*

문자열에 적용할 텍스트 서식 개체입니다.

layoutWidth

형식: FLOAT

레이아웃 상자의 너비입니다.

layoutHeight

형식: FLOAT

레이아웃 상자의 높이입니다.

pixelsPerDip

형식: FLOAT

DIP당 물리적 픽셀 수(디바이스 독립적 픽셀)입니다. 예를 들어 96 DPI 디바이스 픽셀에 렌더링하는 경우 PerDip 은 1입니다. 120 DPI 디바이스 픽셀에 렌더링하는 경우 PerDip 은 1.25(120/96)입니다.

[in, optional] transform

형식: const DWRITE_MATRIX*

문자 모양 및 해당 위치에 적용되는 선택적 변환입니다. 이 변환은 크기 조정이 DIP당 글꼴 크기 및 픽셀을 지정한 후에 적용됩니다.

useGdiNatural

형식: BOOL

FALSE로 설정할 때 GDI 양 수준 텍스트와 동일한 메트릭을 사용하도록 텍스트 레이아웃에 지시 합니다. TRUE로 설정하면 CLEARTYPE_NATURAL_QUALITY 사용하여 만든 글꼴을 사용하여 GDI에서 측정한 텍스트와 동일한 메트릭을 사용하도록 텍스트 레이아웃에 지시합니다.

[out] textLayout

형식: IDWriteTextLayout**

이 메서드가 반환되면 결과 텍스트 레이아웃 개체의 포인터에 대한 주소가 포함됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

결과 텍스트 레이아웃은 의도한 해상도에만 사용해야 하며 텍스트 확장성이 필요한 경우 CreateTextLayout 을 대신 사용해야 합니다.

요구 사항

추가 정보

IDWriteFactory