uisetfont

Open standard dialog box for setting object's font characteristics

Syntax

uisetfont
uisetfont(h)
uisetfont(S)
uisetfont(...,'DialogTitle')
S = uisetfont(...)

Description

uisetfont enables you to change font properties (FontName, FontUnits, FontSize, FontWeight, and FontAngle) for a text, axes, or uicontrol object. The function returns a structure consisting of font properties and values. You can specify an alternate title for the dialog box.

uisetfont displays a modal dialog box and returns the selected font properties.

    Note   A modal dialog box prevents the user from interacting with other windows before responding. For more information, see WindowStyle in Figure Properties.

uisetfont(h) displays a modal dialog box, initializing the font property values with the values of those properties for the object whose handle is h. Selected font property values are applied to the current object. If a second argument is supplied, it specifies a name for the dialog box.

uisetfont(S) displays a modal dialog box, initializing the font property values with the values defined for the specified structure (S). S must define legal values for one or more of these properties: FontName, FontUnits, FontSize, FontWeight, and FontAngle and the field names must match the property names exactly. If other properties are defined, they are ignored. If a second argument is supplied, it specifies a name for the dialog box.

uisetfont(...,'DialogTitle') displays a modal dialog box with the title DialogTitle and returns the values of the font properties selected in the dialog box.

S = uisetfont(...) returns the properties FontName, FontUnits, FontSize, FontWeight, and FontAngle as fields in a structure. If the user presses Cancel from the dialog box or if an error occurs, the output value is set to 0.

Examples

These statements create a text object, then display a dialog box (labeled Update Font) that enables you to change the font characteristics:

h = text(.5,.5,'Figure Annotation');
uisetfont(h,'Update Font')

These statements create two push buttons, then set the font properties of one based on the values set for the other:

% Create push button with string ABC
c1 = uicontrol('Style', 'pushbutton', ...
     'Position', [10 10 100 20], 'String', 'ABC');
% Create push button with string XYZ
c2 = uicontrol('Style', 'pushbutton', ...
     'Position', [10 50 100 20], 'String', 'XYZ');
% Display set font dialog box for c1, make selections,
& and save to d
d = uisetfont(c1);
% Apply those settings to c2
set(c2, d)

See Also

| |

Was this topic helpful?