[C#] StringFormat详解之文本方向、对齐

在使用GDI方式处理文本时，往往会用到StringFormat。里面的某些点有点反直觉，不够直观，所以本篇就通过图文的方式去讲解一下。

本篇内容仅涉及到文本方向、对齐的相关内容。

如有错误、不妥之处，欢迎大家指正。

一、相关属性

与文本方向、对齐相关的属性，主要与三个属性有关：

Alignment、LineAlignment、FormatFlags。

Alignment与LineAlignment的属性值都是StringAlignment枚举。StringAlignment枚举有三个成员：Near、Center、Far。其MSDN解释如下：

FormatFlags的属性值是StringFormatFlags枚举。主要与其枚举的两个成员——DirectionRightToLeft、DirectionVertical——有关。其MSDN解释如下：

二、使用搭配

1，现代文的阅读顺序：水平方向上从左到右、从上到下。

此时，FormatFlags不包含成员DirectionRightToLeft、DirectionVertical。

1.1，对于Alignment，其示意图如下：

此时，StringAlignment枚举的三个成员——Near、Center、Far——可以理解为：

Near：左对齐

Center：居中对齐

Far：右对齐

1.2，对于LineAlignment，其示意图如下：

此时，StringAlignment枚举的三个成员——Near、Center、Far——可以理解为：

Near：文本段落处于显示区域顶部

Center：文本段落处于显示区域中部

Far：文本段落处理显示区域底部

1.3，Alignment和LineAlignment的组合共有9种，如下所示：

2，古文的阅读顺序：垂直方向上从上到下、从右到左。

此时，FormatFlags同时包含成员DirectionRightToLeft、DirectionVertical。

2.1，对于Alignment，其示意图如下：

此时，StringAlignment枚举的三个成员——Near、Center、Far——可以理解为：

Near：顶部对齐

Center：居中对齐

Far：底部对齐

2.2，对于LineAlignment，其示意图如下：

此时，StringAlignment枚举的三个成员——Near、Center、Far——可以理解为：

Near：文本段落处于显示区域右侧

Center：文本段落处于显示区域中侧

Far：文本段落处理显示区域左侧

2.3，Alignment和LineAlignment的组合共有9种，如下所示：

3，其他

除上文两种搭配方式之外，还有两种搭配方式，即分别使用DirectionRightToLeft和DirectionVertical，这两种搭配方式共有18种样式，不过日常几乎用不到。具体想查看可以通过文末提供的示例源代码自行查看。

示例程序截图：

三、重点说明

仅搭配使用而言，并没有什么可多说的，直接使用即可，但是如果想在某个具体的区域内显示文本段落的话——比如上面的示例截图，其坐标的计算是个难点。

这里的“坐标”并不是人眼看上去的坐标，而是使用Graphics.DrawString时所使用的坐标——绘制文本的左上角。

下面进行举例说明。

例1，现代文方式、右对齐、居中显示。

示意图如下所示（这个示意图是用GDI画的，其中绿框是后期为了方便讲解而手动加的）：

其中：

显示区域（上图的蓝色方框）：宽=高=200

文本区域：即字符串所占的矩形区域（上图中绿色方框）：宽：165，高：43

此时，在使用DrawString时，其point（绘制文本的左上角）的坐标并不是绿色方框的左上角：X：200-165＝35，Y：(200-43)/2=78（此处取整数）

其坐标应该是：X：200，Y：200/2=100，即下图中红点所在的坐标（其中黄线是中线）：

是不是很反直觉？

不过当接受了这种坐标计算思路之后，一切就迎刃而解了。

下面再举一个例子：

例2：古文方式、底部对齐、左侧显示

示意图如下所示（这个示意图是用GDI画的，其中绿框是后期为了方便讲解而手动加的）：

其中：

显示区域（上图的蓝色方框）：宽=高=200

文本区域：即字符串所占的矩形区域（上图中绿色方框）：宽：43，高：165

此时，在使用DrawString时，其point（绘制文本的左上角）的坐标并不是绿色方框的左上角：X：0，Y：200-165=35

其坐标应该是：X：0，Y：200，即下图中红点所在的坐标：

四、坐标计算核心代码

完整代码见下方提供的源工程。

 //……

 Bitmap bmpStr = new Bitmap(,);
 PointF stringStart = new PointF(, );

 if (!DirectionRightToLeft)
 {
     if (!DirectionVertical)
     {
         if (alignment == StringAlignment.Near)
         {
             stringStart.X = ;
         }
         else if (alignment == StringAlignment.Center)
         {
             stringStart.X = bmpStr.Width / ;
         }
         else if (alignment == StringAlignment.Far)
         {
             stringStart.X = bmpStr.Width;
         }

         if (lineAlignment == StringAlignment.Near)
         {
             stringStart.Y = ;
         }
         else if (lineAlignment == StringAlignment.Center)
         {
             stringStart.Y = bmpStr.Height / ;
         }
         else if (lineAlignment == StringAlignment.Far)
         {
             stringStart.Y = bmpStr.Height;
         }
     }
     else
     {
         if (alignment == StringAlignment.Near)
         {
             stringStart.Y = ;
         }
         else if (alignment == StringAlignment.Center)
         {
             stringStart.Y = bmpStr.Height / ;
         }
         else if (alignment == StringAlignment.Far)
         {
             stringStart.Y = bmpStr.Height;
         }

         if (lineAlignment == StringAlignment.Near)
         {
             stringStart.X = ;
         }
         else if (lineAlignment == StringAlignment.Center)
         {
             stringStart.X = bmpStr.Width / ;
         }
         else if (lineAlignment == StringAlignment.Far)
         {
             stringStart.X = bmpStr.Width;
         }
     }
 }
 else
 {
     if (!DirectionVertical)
     {
         if (alignment == StringAlignment.Near)
         {
             stringStart.X = bmpStr.Width;
         }
         else if (alignment == StringAlignment.Center)
         {
             stringStart.X = bmpStr.Width / ;
         }
         else if (alignment == StringAlignment.Far)
         {
             stringStart.X = ;
         }

         if (lineAlignment == StringAlignment.Near)
         {
             stringStart.Y = ;
         }
         else if (lineAlignment == StringAlignment.Center)
         {
             stringStart.Y = bmpStr.Height / ;
         }
         else if (lineAlignment == StringAlignment.Far)
         {
             stringStart.Y = bmpStr.Height;
         }
     }
     else
     {
         if (alignment == StringAlignment.Near)
         {
             stringStart.Y = ;
         }
         else if (alignment == StringAlignment.Center)
         {
             stringStart.Y = bmpStr.Height / ;
         }
         else if (alignment == StringAlignment.Far)
         {
             stringStart.Y = bmpStr.Height;
         }

         if (lineAlignment == StringAlignment.Near)
         {
             stringStart.X = bmpStr.Width;
         }
         else if (lineAlignment == StringAlignment.Center)
         {
             stringStart.X = bmpStr.Width / ;
         }
         else if (lineAlignment == StringAlignment.Far)
         {
             stringStart.X = ;
         }
     }
 }

 //……

 g.DrawString(str, font, new SolidBrush(Color.Red), stringStart, stringFormat);

 //……

坐标计算

五、示例程序源代码下载

源工程文件：

https://files.cnblogs.com/files/lesliexin/StringFormat.7z