TextSetFont

该函数使用绘制方法设置展示文本的字体并返回操作结果。默认使用-120 (12 pt)大小的Arial字体。

bool  TextSetFont(
   const string  name,            // 字体名称或磁盘上字体文件的路径
   int           size,            // 字体大小
   uint          flags,           // 混合标识
   int           orientation=0    // 文本方向
   );

参数

name

[in]  系统字体名称或包括字体或磁盘字体文件路径的资源名称。

size

[in]  字体大小。

flags

[in]  描述字体样式的混合标识

orientation

[in]  X轴的文本水平倾斜,测量单位0.1度。它表示方向=450象征倾斜45度。

返回值

如果当前字体成功安装,返回true,否则返回false。可能的错误代码:

  • ERR_INVALID_PARAMETER(4003) - name 显示 NULL 或 "" (空字符串),
  • ERR_INTERNAL_ERROR(4001) - 操作系统错误 (例如,试图创建不存在的字体)。

注意

如果"::" 被用作字体名称,字体从 EX5 资源下载。如果name字体名称扩展指定,字体从文件下载,如果路径从"\"或"/"开始,文件相对MQL5目录搜索。否则,相对调用TextSetFont()函数的EX5文件路径搜索。

字体大小使用正负值进行设置。该事实从操作系统设置定义了文本大小的依赖性(大小比例)。

  • 如果大小指定正数,那么当从逻辑字体变为物理字体时,该大小转变为设备的物理测量单位(像素),并且该大小符合从有效字体挑选的符号图形高度。当在图表上一起使用通过TextOut(函数展示的文本和通过OBJ_LABEL ("标签") 图形物件展示的文本时,这种情况不被推荐。
  • 如果大小指定负数,那么该数字被认为是逻辑点的十分之一(-350等于35逻辑点)并且被10除。获得的值然后转变为设备的物理测量单位(像素),并且符合从有效字体挑选的符号高度的绝对值。物件属性中指定的字体大小乘以-10,使得屏幕上的文本大小类似OBJ_LABEL物件的文本大小。

该标识可以被用作样式标识和指定字体宽度标识的结合体。标识名称显示如下。

指定字体样式的标识

标识

描述

FONT_ITALIC

斜体字

FONT_UNDERLINE

下划线

FONT_STRIKEOUT

加删除线

 

指定字体宽度的标识

标识

FW_DONTCARE

FW_THIN

FW_EXTRALIGHT

FW_ULTRALIGHT

FW_LIGHT

FW_NORMAL

FW_REGULAR

FW_MEDIUM

FW_SEMIBOLD

FW_DEMIBOLD

FW_BOLD

FW_EXTRABOLD

FW_ULTRABOLD

FW_HEAVY

FW_BLACK

另见

资源ResourceCreate()ResourceSave()TextOut()