IDWriteTextFormat 인터페이스(dwrite.h)

IDWriteTextFormat 인터페이스는 텍스트 서식을 지정하는 데 사용되는 글꼴 및 단락 속성을 설명하고 로캘 정보를 설명합니다.

상속

IDWriteTextFormat 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IDWriteTextFormat 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IDWriteTextFormat 인터페이스에는 이러한 메서드가 있습니다.

IDWriteTextFormat::GetFlowDirection 텍스트 줄이 흐르는 방향을 가져옵니다.
IDWriteTextFormat::GetFontCollection 현재 글꼴 컬렉션을 가져옵니다.
IDWriteTextFormat::GetFontFamilyName 글꼴 패밀리 이름의 복사본을 가져옵니다.
IDWriteTextFormat::GetFontFamilyNameLength 글꼴 패밀리 이름의 길이를 가져옵니다.
IDWriteTextFormat::GetFontSize DIP 통합의 글꼴 크기를 가져옵니다.
IDWriteTextFormat::GetFontStretch 텍스트의 글꼴 스트레치를 가져옵니다.
IDWriteTextFormat::GetFontStyle 텍스트의 글꼴 스타일을 가져옵니다.
IDWriteTextFormat::GetFontWeight 텍스트의 글꼴 두께를 가져옵니다.
IDWriteTextFormat::GetIncrementalTabStop 증분 탭 중지 위치를 가져옵니다.
IDWriteTextFormat::GetLineSpacing 여러 줄 텍스트 단락의 줄 간격 조정 집합을 가져옵니다. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName 로캘 이름의 복사본을 가져옵니다.
IDWriteTextFormat::GetLocaleNameLength 로캘 이름의 길이를 가져옵니다.
IDWriteTextFormat::GetParagraphAlignment 레이아웃 상자의 위쪽 및 아래쪽 가장자리를 기준으로 하는 단락의 맞춤 옵션을 가져옵니다.
IDWriteTextFormat::GetReadingDirection 단락의 텍스트에 대한 현재 읽기 방향을 가져옵니다.
IDWriteTextFormat::GetTextAlignment 레이아웃 상자의 선행 및 후행 가장자리를 기준으로 텍스트의 맞춤 옵션을 가져옵니다.
IDWriteTextFormat::GetTrimming 레이아웃 상자를 오버플로하는 텍스트에 대한 트리밍 옵션을 가져옵니다.
IDWriteTextFormat::GetWordWrapping 단어 줄 바꿈 옵션을 가져옵니다.
IDWriteTextFormat::SetFlowDirection 단락 흐름 방향을 설정합니다.
IDWriteTextFormat::SetIncrementalTabStop 인접한 두 탭 정지 사이의 고정 거리를 설정합니다.
IDWriteTextFormat::SetLineSpacing 줄 간격을 설정합니다.
IDWriteTextFormat::SetParagraphAlignment 레이아웃 상자의 위쪽 및 아래쪽 가장자리를 기준으로 단락의 맞춤 옵션을 설정합니다.
IDWriteTextFormat::SetReadingDirection 단락 읽기 방향을 설정합니다.
IDWriteTextFormat::SetTextAlignment IDWriteTextFormat 인터페이스에 대한 레이아웃 상자의 선행 및 후행 가장자리를 기준으로 단락의 텍스트 맞춤을 설정합니다.
IDWriteTextFormat::SetTrimming 레이아웃 너비를 오버플로하는 텍스트에 대한 트리밍 옵션을 설정합니다.
IDWriteTextFormat::SetWordWrapping 단어 줄 바꿈 옵션을 설정합니다.

설명

IDWriteTextFormat 인터페이스에 대한 참조를 가져오려면 애플리케이션은 다음 코드와 같이 IDWriteFactory::CreateTextFormat 메서드를 호출해야 합니다.

if (SUCCEEDED(hr))
{
    hr = pDWriteFactory_->CreateTextFormat(
        L"Gabriola",
        NULL,
        DWRITE_FONT_WEIGHT_REGULAR,
        DWRITE_FONT_STYLE_NORMAL,
        DWRITE_FONT_STRETCH_NORMAL,
        72.0f,
        L"en-us",
        &pTextFormat_
        );
}

CreateTextFormat 함수를 사용하여 IDWriteTextFormat 개체를 만들 때 애플리케이션은 텍스트 형식에 대한 글꼴 패밀리, 글꼴 컬렉션, 글꼴 두께, 글꼴 크기 및 로캘 이름을 지정합니다.

IDWriteTextFormat 개체를 만든 후에는 이러한 속성을 변경할 수 없습니다. 이러한 속성을 변경하려면 원하는 속성을 사용하여 새 IDWriteTextFormat 개체를 만들어야 합니다.

IDWriteTextFormat 인터페이스는 단일 형식으로 텍스트를 그리는 데 사용됩니다.

여러 형식으로 텍스트를 그리거나 사용자 지정 텍스트 렌더러를 사용하려면 IDWriteTextLayout 인터페이스를 사용합니다. IDWriteTextLayout 을 사용하면 애플리케이션이 문자열 내의 텍스트 범위에 대한 형식을 변경할 수 있습니다. IDWriteFactory::CreateTextLayout은 IDWriteTextFormat 개체를 매개 변수로 사용하고 처음에는 형식 정보를 전체 문자열에 적용합니다.

이 개체는 스레드로부터 안전하지 않을 수 있으며 텍스트 형식 변경 상태를 전달할 수 있습니다.

DirectWrite 및 Direct2D

단일 형식으로 간단한 텍스트를 그리기 위해 Direct2D 는 ID2D1RenderTarget::D rawText 메서드를 제공합니다. 이 메서드는 IDWriteTextFormat 개체에서 제공하는 형식 정보를 사용하여 문자열을 그립니다.

요구 사항

지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite.h