---
title: "convert(_:toHaveTrait:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsfontmanager/convert(_:tohavetrait:)"
---

# convert(_:toHaveTrait:)

Returns a new version of the font object containing a single additional trait.

## Declaration

```swift
func convert(_ fontObj: NSFont, toHaveTrait trait: NSFontTraitMask) -> NSFont
```

## Parameters

- `fontObj`: The font whose traits are matched.
- `trait`: 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

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

## Discussion

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

## See Also

### Related Documentation

- [convert(_:)](appkit/nsfontmanager/convert(_:).md)

### Converting Fonts Manually

- [convert(_:toFace:)](appkit/nsfontmanager/convert(_:toface:).md)
- [convert(_:toFamily:)](appkit/nsfontmanager/convert(_:tofamily:).md)
- [convert(_:toNotHaveTrait:)](appkit/nsfontmanager/convert(_:tonothavetrait:).md)
- [convert(_:toSize:)](appkit/nsfontmanager/convert(_:tosize:).md)
- [convertWeight(_:of:)](appkit/nsfontmanager/convertweight(_:of:).md)
- [currentFontAction](appkit/nsfontmanager/currentfontaction.md)
- [convertFontTraits(_:)](appkit/nsfontmanager/convertfonttraits(_:).md)