在使用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