METODE IDWriteBitmapRenderTarget::D rawGlyphRun (dwrite.h)

Artikel
08/23/2023

Menggambar eksekusi glyph ke target bitmap pada posisi yang ditentukan.

Sintaks

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

Parameter

baselineOriginX

Jenis: FLOAT

Posisi horizontal asal garis besar, dalam DIP, relatif terhadap sudut kiri atas DIB.

baselineOriginY

Jenis: FLOAT

Posisi vertikal asal garis besar, dalam DIP, relatif terhadap sudut kiri atas DIB.

measuringMode

Jenis: DWRITE_MEASURING_MODE

Metode pengukur untuk glyph dalam eksekusi, digunakan dengan properti lain untuk menentukan mode penyajian.

[in] glyphRun

Jenis: const DWRITE_GLYPH_RUN*

Struktur yang berisi properti eksekusi glyph.

renderingParams

Jenis: IDWriteRenderingParams*

Objek yang mengontrol perilaku penyajian.

textColor

Jenis: COLORREF

Warna latar depan teks.

[out, optional] blackBoxRect

Jenis: RECT*

Persegi opsional yang menerima kotak pembatas (dalam piksel bukan DIP) dari semua piksel yang terpengaruh dengan menggambar eksekusi glyph. Persegi panjang kotak hitam dapat melampaui dimensi bitmap.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Anda dapat menggunakan IDWriteBitmapRenderTarget::D rawGlyphRun untuk merender ke bitmap dari perender teks kustom yang Anda terapkan. Perender teks kustom harus memanggil metode ini dari dalam metode panggilan balik IDWriteTextRenderer::D rawGlyphRun seperti yang ditunjukkan dalam kode berikut.

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

Parameter baselineOriginX, baslineOriginY, measuringMethod, dan glyphRun disediakan (sebagai argumen) ketika metode panggilan balik dipanggil. RenderingParams, textColor, dan blackBoxRect tidak.

Param penyajian default dapat diambil dengan menggunakan metode IDWriteFactory::CreateMonitorRenderingParams .

Persyaratan


Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	dwrite.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll

Lihat juga

IDWriteBitmapRenderTarget

Share via