Fork me on GitHub

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     // 字体格式1:不使用去尾
 2     if (SUCCEEDED(hr))
 3     {
 4         DWRITE_TRIMMING trim1;
 5         IDWriteInlineObject* trim2 = NULL;
 6         hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
 7             DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF1);
 8 
 9         if (SUCCEEDED(hr))
10         {                    // 换行模式(DWRITE_WORD_WRAPPING)设置为不换行
11             hr = m_pTF1->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
12         }
13 
14         if (SUCCEEDED(hr))
15         {
16             trim1.granularity = DWRITE_TRIMMING_GRANULARITY_NONE;
17             trim1.delimiter = 1;
18             trim1.delimiterCount = 10;
19             hr = m_pTF1->SetTrimming(&trim1,trim2);
20         }
21     }

 

b)以字符为单位去尾
 1     // 字体格式2:以字符为单位去尾
 2     if (SUCCEEDED(hr))
 3     {
 4         DWRITE_TRIMMING trim1;
 5         IDWriteInlineObject* trim2 = NULL;
 6         hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
 7             DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF2);
 8 
 9         if (SUCCEEDED(hr))
10         {                        // 换行模式(DWRITE_WORD_WRAPPING)设置为不换行
11             hr = m_pTF2->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
12         }
13 
14         if (SUCCEEDED(hr))
15         {
16             trim1.granularity = DWRITE_TRIMMING_GRANULARITY_CHARACTER;
17             trim1.delimiter = 1;
18             trim1.delimiterCount = 10;
19             hr = m_pTF2->SetTrimming(&trim1,trim2);
20         }
21     }

 

c)以单词为单位去尾
 1     // 字体格式3:以单词为单位去尾
 2     if (SUCCEEDED(hr))
 3     {
 4         DWRITE_TRIMMING trim1;
 5         IDWriteInlineObject* trim2 = NULL;
 6         hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
 7             DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF3);
 8 
 9         if (SUCCEEDED(hr))
10         {                        // 换行模式(DWRITE_WORD_WRAPPING)设置为不换行
11             hr = m_pTF3->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
12         }
13 
14         if (SUCCEEDED(hr))
15         {
16             trim1.granularity = DWRITE_TRIMMING_GRANULARITY_WORD;
17             trim1.delimiter = 1;
18             trim1.delimiterCount = 10;
19             hr = m_pTF3->SetTrimming(&trim1,trim2);
20         }
21     }

 

d)以字符为单位去尾,用省略号代替略去部分
 1     // 字体格式4:以字符为单位去尾,用省略号代替略去部分
 2     if (SUCCEEDED(hr))
 3     {
 4         DWRITE_TRIMMING trim1;
 5         IDWriteInlineObject* trim2 = NULL;
 6         hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
 7             DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF4);
 8 
 9         if (SUCCEEDED(hr))
10         {                        // 换行模式(DWRITE_WORD_WRAPPING)设置为不换行
11             hr = m_pTF4->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
12         }
13 
14         if (SUCCEEDED(hr))
15         {              // 
16             m_pDWriteFactory->CreateEllipsisTrimmingSign(m_pTF4,&trim2);
17         }
18 
19         if (SUCCEEDED(hr))
20         {
21             trim1.granularity = DWRITE_TRIMMING_GRANULARITY_CHARACTER;
22             trim1.delimiter = 1;
23             trim1.delimiterCount = 10;
24             hr = m_pTF4->SetTrimming(&trim1,trim2);
25         }
26     }

 

e)以单词为单位去尾,用省略号代替略去部分
 1     // 字体格式4:以字符为单位去尾,用省略号代替略去部分
 2     if (SUCCEEDED(hr))
 3     {
 4         DWRITE_TRIMMING trim1;
 5         IDWriteInlineObject* trim2 = NULL;
 6         hr = m_pDWriteFactory->CreateTextFormat( L"Arial Black", NULL, DWRITE_FONT_WEIGHT_NORMAL, 
 7             DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL, 20.0, L"en-us",&m_pTF4);
 8 
 9         if (SUCCEEDED(hr))
10         {                        // 换行模式(DWRITE_WORD_WRAPPING)设置为不换行
11             hr = m_pTF4->SetWordWrapping(DWRITE_WORD_WRAPPING_NO_WRAP);
12         }
13 
14         if (SUCCEEDED(hr))
15         {
16             m_pDWriteFactory->CreateEllipsisTrimmingSign(m_pTF4,&trim2);
17         }
18 
19         if (SUCCEEDED(hr))
20         {
21             trim1.granularity = DWRITE_TRIMMING_GRANULARITY_CHARACTER;
22             trim1.delimiter = 1;
23             trim1.delimiterCount = 10;
24             hr = m_pTF4->SetTrimming(&trim1,trim2);
25         }
26     }
 
根据我们的实验发现,如果要实现“字符串去尾”的显示效果,必须先将换行模式(DWRITE_WORD_WRAPPING)设置为不换行;注意让显示的字符串长度超出目标矩形宽度,这样才能看出字符串去尾的效果。
 
在此Demo中,为了更好的展示出字符串去尾的视觉效果,我们将字符串绘制的目标矩形范围使用绿色画刷绘制出来,如下:

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

posted @ 2016-07-11 15:44  江湖码客Mark  阅读(1727)  评论(2编辑  收藏  举报