Instance Method

convertFont:toHaveTrait:

Returns a font whose traits are the same as those of the given font, except that the traits are changed to include the single specified trait.

Declaration

- (NSFont *)convertFont:(NSFont *)fontObj toHaveTrait:(NSFontTraitMask)trait;

Parameters

aFont

The font whose traits are matched.

fontTrait

The new trait; may be any one of the traits described in Constants. Using NSUnboldFontMask or NSUnitalicFontMask removes the bold or italic trait, respectively.

Return Value

A font with matching traits including the given trait, or aFont if it can’t be converted.

Discussion

Using NSUnboldFontMask or NSUnitalicFontMask removes the bold or italic trait, respectively.

See Also

Converting Fonts Manually

- convertFont:toFace:

Returns a font whose traits are as similar as possible to those of the given font except for the typeface, which is changed to the given typeface.

- convertFont:toFamily:

Returns a font whose traits are as similar as possible to those of the given font except for the font family, which is changed to the given family.

- convertFont:toNotHaveTrait:

Returns an NSFont object with the same traits as the given font, except for the traits in the given font trait mask, which are removed.

- convertFont:toSize:

Returns an NSFont object whose traits are the same as those of the given font, except for the size, which is changed to the given size.

- convertWeight:ofFont:

Returns an NSFont object whose weight is greater or lesser than that of the given font, if possible.

currentFontAction

The current font conversion action.

- convertFontTraits:

Converts font traits to a new traits mask value.