IDWriteBitmapRenderTarget::D rawGlyphRun 메서드(dwrite.h)

지정된 위치에 있는 비트맵 대상에 문자 모양 실행을 그립니다.

구문

HRESULT DrawGlyphRun(
                  FLOAT                  baselineOriginX,
                  FLOAT                  baselineOriginY,
                  DWRITE_MEASURING_MODE  measuringMode,
  [in]            DWRITE_GLYPH_RUN const *glyphRun,
                  IDWriteRenderingParams *renderingParams,
                  COLORREF               textColor,
  [out, optional] RECT                   *blackBoxRect
);

매개 변수

baselineOriginX

형식: FLOAT

DIB의 왼쪽 위 모서리를 기준으로 기준선 원점의 가로 위치(DIP)입니다.

baselineOriginY

형식: FLOAT

DIB의 왼쪽 위 모서리를 기준으로 기준선 원점의 세로 위치(DIP)입니다.

measuringMode

형식: DWRITE_MEASURING_MODE

렌더링 모드를 결정하기 위해 다른 속성과 함께 사용되는 실행의 문자 모양에 대한 측정 메서드입니다.

[in] glyphRun

형식: const DWRITE_GLYPH_RUN*

문자 모양 실행의 속성을 포함하는 구조체입니다.

renderingParams

형식: IDWriteRenderingParams*

렌더링 동작을 제어하는 개체입니다.

textColor

형식: COLORREF

텍스트의 전경색입니다.

[out, optional] blackBoxRect

형식: RECT*

문자 모양 실행을 그려 영향을 받는 모든 픽셀의 경계 상자(DIP가 아닌 픽셀)를 수신하는 선택적 사각형입니다. 블랙 박스 사각형은 비트맵의 차원 이상으로 확장할 수 있습니다.

반환 값

형식: HRESULT

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

설명

IDWriteBitmapRenderTarget::D rawGlyphRun을 사용하여 구현하는 사용자 지정 텍스트 렌더러에서 비트맵으로 렌더링할 수 있습니다. 사용자 지정 텍스트 렌더러는 다음 코드와 같이 IDWriteTextRenderer::D rawGlyphRun 콜백 메서드 내에서 이 메서드를 호출해야 합니다.

STDMETHODIMP GdiTextRenderer::DrawGlyphRun(
    __maybenull void* clientDrawingContext,
    FLOAT baselineOriginX,
    FLOAT baselineOriginY,
    DWRITE_MEASURING_MODE measuringMode,
    __in DWRITE_GLYPH_RUN const* glyphRun,
    __in DWRITE_GLYPH_RUN_DESCRIPTION const* glyphRunDescription,
    IUnknown* clientDrawingEffect
    )
{
    HRESULT hr = S_OK;

    // Pass on the drawing call to the render target to do the real work.
    RECT dirtyRect = {0};

    hr = pRenderTarget_->DrawGlyphRun(
        baselineOriginX,
        baselineOriginY,
        measuringMode,
        glyphRun,
        pRenderingParams_,
        RGB(0,200,255),
        &dirtyRect
        );
    

    return hr;
}

baselineOriginX, baslineOriginY, 측정Method 및 glyphRun 매개 변수는 콜백 메서드가 호출될 때(인수로) 제공됩니다. renderingParams, textColor 및 blackBoxRect는 그렇지 않습니다.

IDWriteFactory::CreateMonitorRenderingParams 메서드를 사용하여 기본 렌더링 매개 변수를 검색할 수 있습니다.

요구 사항

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

추가 정보

IDWriteBitmapRenderTarget