Main Content

uisetfont

打开字体选择对话框

说明

uisetfont 打开模态字体对话框,并选中默认的字体名称和字体样式值。如果用户点击确定,将在 MATLAB® 命令行窗口返回选定的字体属性。如果用户点击取消或对话框标题栏中的关闭按钮 (X),将在命令行窗口返回值 0

示例

uisetfont(h) 指定“字体”对话框要操作的对象。对话框打开时显示的值是该对象的当前设置。

h 的值可以是 textaxesuicontrol 对象。

uisetfont(optsin) 使用为指定的 optsin 结构体定义的值初始化“字体”对话框中的选择项。

uisetfont(___,title) 为“字体”对话框指定自定义标题。此语法可以包括上述语法中的任何输入参数。

示例

当用户点击确定时,optsout = uisetfont(___) 会将在对话框中选择的值返回到 optsout 结构体。如果用户点击取消或发生错误,optsout 将设置为 0。此语法可以不指定输入参数,也可以指定上述语法中的任何输入参数。

示例

全部折叠

创建一个包含文本注释的绘图。

f = figure('Position',[200 200 392 294]);
x = 0:pi/20:2*pi;
y = sin(x);
plot(x,y);
t = text(pi,0,'\leftarrow sin(\pi)');

Plot of a sine function with the text "sin(π)" pointing to the curve

打开字体对话框,并选择粗斜体样式。(对话框中显示的字体名称取决于系统。)

optsout = uisetfont(t);

Font dialog box. The dialog box contains fields to select the font name, style, and size, and displays sample text with the selected font characteristics. The bottom of the dialog box has two buttons: "OK" and "Cancel".

点击确定。绘图注释的字体样式将改变。

Plot of a sine function with the text "sin(π)" pointing to the curve. The text is bold and italic.

输入参数

全部折叠

字体更改的目标对象,指定为 AxesTextUIControl 对象。

字体值,指定为由字体属性组成的结构体。

下表列出了结构体字段、默认值以及用户可用来更改这些值的对话框控件。

结构体字段

结构体字段默认值对话框控件
FontName取决于系统字体列表。
FontWeight'normal'样式列表。
FontAngle'normal'样式列表。
FontUnits'points' 未提供,因为对于受支持的对象,FontUnits 的值始终为 'points'
FontSize取决于系统大小列表

结构体字段值 'normal' 对应于对话框的样式列表中的纯文本

用户可以从列表中选择大小值,也可以键入未列出的值。如果用户输入浮点数,MATLAB 会在存储之前将其舍入到最接近的整数值。

示例: optsin.FontWeight = 'bold';

对话框标题,指定为字符向量或字符串标量。

示例: 'Font Selection'

输出参数

全部折叠

字体值,以字体属性值结构体的形式返回。结构体字段包括:

  • FontName

  • FontWeight

  • FontAngle

  • FontUnits

  • FontSize

如果用户为对应于 FontSize 值的对话框字段键入了浮点数,MATLAB 会在返回之前将其舍入到最接近的整数值。

详细信息

全部折叠

模态对话框

模态对话框阻止用户在响应该对话框之前与其他 MATLAB 窗口进行交互。

版本历史记录

在 R2006a 之前推出

另请参阅

| |