Ets_Shape_Label_Create()
**注意:**需要 OPNET Development Kit
摘要
创建一个新的标签形状。
语法
Ets_Shape_Label_Create (text_lines_lptr, label_box, font_str, fg_color, bg_color, line_spacing, alignment, angle)
| 参数 | 类型 | 说明 |
|---|---|---|
text_lines_lptr |
PrgT_List * |
指向标签文本字符串列表的指针。 |
label_box |
EtsT_Shape_Rect |
定义标签区域的矩形。关于矩形坐标的详情,参见形状数据类型。 |
font_str |
EtsT_Shape_Font_Name |
文本所用字体的名称。 |
fg_color |
EtsT_Color |
前景色(用于文本字符)。详情参见形状颜色。 |
bg_color |
EtsT_Color |
背景色(用于填充标签框)。详情参见形状颜色。若不填充,使用 EtsT_Shape_Color_None。 |
line_spacing |
double |
行间距,基于文本大小(如"详情"小节所述)。 |
alignment |
EtsT_Shape_Align |
文本在标签框内的水平位置,可取左对齐、居中或右对齐(使用表 26中的文本对齐常量)。 |
angle |
double |
标签的旋转角度,以从水平方向逆时针计量的度数表示。0.0 表示不旋转。 |
返回类型
EtsT_Shape_Handle
新形状的句柄。
头文件
ets_api_shapeset.h
详情
标签形状是一个或多个以单一对象形式显示的文本字符串。文本可以显示在填充的框中,并以任意角度旋转。文本大小与放置位置按如下方式确定:
- 如果
label_box定义一个矩形,文本会被缩放以适应指定区域。 - 如果
label_box定义一个点(即最小值与最大值相同),该点将用作标签的中心,文本大小由指定的字体决定。
行间距基于文本大小。正常间距时将 line_spacing 设为 1.0;双倍行距(文本行之间空一行)时将 line_spacing 设为 2.0,依此类推。