Metodo IDWriteBitmapRenderTarget::D rawGlyphRun (dwrite.h)

Disegna un'esecuzione di glifi a una destinazione bitmap nella posizione specificata.

Sintassi

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

Parametri

baselineOriginX

Tipo: FLOAT

Posizione orizzontale dell'origine della baseline, in DIP, rispetto all'angolo superiore sinistro del DIB.

baselineOriginY

Tipo: FLOAT

Posizione verticale dell'origine di base, in DIP, rispetto all'angolo superiore sinistro del DIB.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Metodo di misurazione per glifi nell'esecuzione, usato con le altre proprietà per determinare la modalità di rendering.

[in] glyphRun

Tipo: const DWRITE_GLYPH_RUN*

Struttura contenente le proprietà dell'esecuzione del glifo.

renderingParams

Tipo: IDWriteRenderingParams*

Oggetto che controlla il comportamento di rendering.

textColor

Tipo: COLORREF

Colore di primo piano del testo.

[out, optional] blackBoxRect

Tipo: RECT*

Rettangolo facoltativo che riceve il rettangolo di selezione (in pixel non DIP) di tutti i pixel interessati dal disegno dell'esecuzione del glifo. Il rettangolo della casella nera può estendersi oltre le dimensioni della bitmap.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È possibile usare IDWriteBitmapRenderTarget::D rawGlyphRun per eseguire il rendering in una bitmap da un renderer di testo personalizzato implementato. Il renderer di testo personalizzato deve chiamare questo metodo dall'interno del metodo IDWriteTextRenderer::D rawGlyphRun , come illustrato nel codice seguente.

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;
}

I parametri baselineOriginX, baslineOriginY, misurazioneMethod e glyphRun vengono forniti (come argomenti) quando viene richiamato il metodo callback. Il renderingParams, textColor e blackBoxRect non sono.

I params di rendering predefiniti possono essere recuperati usando il metodo IDWriteFactory::CreateMonitorRenderingParams .

Requisiti

Vedi anche

IDWriteBitmapRenderTarget