DirectWrite文字排版——字符串去尾

DirectWrite是 DirectX 家族中专门用来做文本处理的部分，主要配合Direct2D进行渲染工作。

一、字符串去尾介绍

在文字渲染中，不免会遇到字符串去尾的需求。字符串去尾指的是：当字符串在指定的RECT中无法全部显示时，如何对文本进行截取，以适应目标区域大小；DirectWrite中的介绍是设置溢出布局宽度的文本的剪裁。我们把这种截取操作称为“字符串去尾”。

 

首先，给大家介绍一个DirectWrite中的类，IDWriteTextFormat类用于格式化文本的字体和段落属性，并且它还描述区域设置信息。

 

(1)IDWriteTextFormat::SetTrimming 方法

　　设置溢出布局宽度的文本的剪裁选项。

　　语法

　　virtual HRESULT SetTrimming(
  　　[in]  const DWRITE_TRIMMING * trimmingOptions,
        　　IDWriteInlineObject * trimmingSign
　　) = 0;

　　参数

　　trimmingOptions [in]

　　文本剪裁选项。

　　trimmingSign

　　应用程序定义的忽略符号。此参数可为 NULL。注意：我们想要用到省略号代替裁剪部分就需要用到这个参数。

　　返回值

　　如果该方法成功，则返回 S_OK。 否则，将返回错误代码。HRESULT.

 

(2)DWRITE_TRIMMING 结构 (SetTrimming函数的第一个参数)

　　指定用于溢出布局框的文本的剪裁选项。

　　语法

　　struct DWRITE_TRIMMING { 
  　　DWRITE_TRIMMING_GRANULARITY granularity; 
  　　UINT32                      delimiter; 
  　　UINT32                      delimiterCount; 
　　};

　　成员

　　granularity

　　一个值，指定用于对溢出布局框的文本进行剪裁的文本粒度。

　　enum DWRITE_TRIMMING_GRANULARITY { 
  　　DWRITE_TRIMMING_GRANULARITY_NONE, 　　　　 //不进行任何剪裁。文本流超出布局宽度。
  　　DWRITE_TRIMMING_GRANULARITY_CHARACTER, 　 //在字符群集边界处进行剪裁
  　　DWRITE_TRIMMING_GRANULARITY_WORD  　　　　//在字边界处进行剪裁
　　};

　　delimiter

　　一个字符代码，用作指示要保留的文本部分开头的分隔符。对路径省略号最有用，其中分隔符为斜杠。

　　delimiterCount

　　一个值，指示要后退的分隔符数量。

 

(3)DWriteFactory::CreateEllipsisTrimmingSign()方法

　　此方法可以生成表示省略号的 IDWriteInlineObject（此方法得到的IDWriteInlineObject可以作为SetTrimming方法的第二个参数）。

二、实现字符串去尾效果

字符串裁剪效果完全可以通过配置IDWriteTextFormat对象来实现。下面来展示5种不同情况的字符串去尾效果的IDWriteTextFormat对象的创建及配置过程：

 

a）不使用去尾

    // 字体格式1：不使用去尾
    if (SUCCEEDED(hr))
    {
        DWRITE_TRIMMING trim1;
        IDWriteInlineObject* trim2 = NULL;
        hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
            DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF1);

        if (SUCCEEDED(hr))
        {                    // 换行模式（DWRITE_WORD_WRAPPING）设置为不换行
            hr = m_pTF1->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
        }

        if (SUCCEEDED(hr))
        {
            trim1.granularity = DWRITE_TRIMMING_GRANULARITY_NONE;
            trim1.delimiter = 1;
            trim1.delimiterCount = 10;
            hr = m_pTF1->SetTrimming(&trim1,trim2);
        }
    }

b）以字符为单位去尾

    // 字体格式2：以字符为单位去尾
    if (SUCCEEDED(hr))
    {
        DWRITE_TRIMMING trim1;
        IDWriteInlineObject* trim2 = NULL;
        hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
            DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF2);

        if (SUCCEEDED(hr))
        {                        // 换行模式（DWRITE_WORD_WRAPPING）设置为不换行
            hr = m_pTF2->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
        }

        if (SUCCEEDED(hr))
        {
            trim1.granularity = DWRITE_TRIMMING_GRANULARITY_CHARACTER;
            trim1.delimiter = 1;
            trim1.delimiterCount = 10;
            hr = m_pTF2->SetTrimming(&trim1,trim2);
        }
    }

c）以单词为单位去尾

    // 字体格式3：以单词为单位去尾
    if (SUCCEEDED(hr))
    {
        DWRITE_TRIMMING trim1;
        IDWriteInlineObject* trim2 = NULL;
        hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
            DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF3);

        if (SUCCEEDED(hr))
        {                        // 换行模式（DWRITE_WORD_WRAPPING）设置为不换行
            hr = m_pTF3->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
        }

        if (SUCCEEDED(hr))
        {
            trim1.granularity = DWRITE_TRIMMING_GRANULARITY_WORD;
            trim1.delimiter = 1;
            trim1.delimiterCount = 10;
            hr = m_pTF3->SetTrimming(&trim1,trim2);
        }
    }

d）以字符为单位去尾，用省略号代替略去部分

    // 字体格式4：以字符为单位去尾，用省略号代替略去部分
    if (SUCCEEDED(hr))
    {
        DWRITE_TRIMMING trim1;
        IDWriteInlineObject* trim2 = NULL;
        hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
            DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF4);

        if (SUCCEEDED(hr))
        {                        // 换行模式（DWRITE_WORD_WRAPPING）设置为不换行
            hr = m_pTF4->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
        }

        if (SUCCEEDED(hr))
        {　　　　　　　　　　　　　　// 
            m_pDWriteFactory->CreateEllipsisTrimmingSign(m_pTF4,&trim2);
        }

        if (SUCCEEDED(hr))
        {
            trim1.granularity = DWRITE_TRIMMING_GRANULARITY_CHARACTER;
            trim1.delimiter = 1;
            trim1.delimiterCount = 10;
            hr = m_pTF4->SetTrimming(&trim1,trim2);
        }
    }

e）以单词为单位去尾，用省略号代替略去部分

    // 字体格式4：以字符为单位去尾，用省略号代替略去部分
    if (SUCCEEDED(hr))
    {
        DWRITE_TRIMMING trim1;
        IDWriteInlineObject* trim2 = NULL;
        hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
            DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF4);

        if (SUCCEEDED(hr))
        {                        // 换行模式（DWRITE_WORD_WRAPPING）设置为不换行
            hr = m_pTF4->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
        }

        if (SUCCEEDED(hr))
        {
            m_pDWriteFactory->CreateEllipsisTrimmingSign(m_pTF4,&trim2);
        }

        if (SUCCEEDED(hr))
        {
            trim1.granularity = DWRITE_TRIMMING_GRANULARITY_CHARACTER;
            trim1.delimiter = 1;
            trim1.delimiterCount = 10;
            hr = m_pTF4->SetTrimming(&trim1,trim2);
        }
    }

 

根据我们的实验发现，如果要实现“字符串去尾”的显示效果，必须先将换行模式（DWRITE_WORD_WRAPPING）设置为不换行；注意让显示的字符串长度超出目标矩形宽度，这样才能看出字符串去尾的效果。

 

在此Demo中，为了更好的展示出字符串去尾的视觉效果，我们将字符串绘制的目标矩形范围使用绿色画刷绘制出来,如下：

想看源码的朋友可以点击此处下载，Demo源码是Direct2DTests目录下的DWriteStringTrimming文件。