Contents

font(withFamily:traits:weight:size:)

Attempts to load a font with the specified characteristics.

Declaration

func font(withFamily family: String, traits: NSFontTraitMask, weight: Int, size: CGFloat) -> NSFont?

Parameters

  • family:

    The generic name of the desired font, such as Times or Helvetica.

  • traits:

    The font traits, specified by combining the font trait mask values described in Constants using the C bitwise OR operator. Using NSUnboldFontMask or NSUnitalicFontMask loads a font that doesn’t have either the bold or italic trait, respectively.

  • weight:

    A hint for the weight desired, on a scale of 0 to 15: a value of 5 indicates a normal or book weight, and 9 or more a bold or heavier weight. The weight is ignored if fontTraitMask includes NSBoldFontMask.

  • size:

    The point size of the desired font.

Return Value

A font with the specified characteristics if successful, or nil if not.