draw(with:options:)
Draws the attributed string with the specified options within the specified rectangle in the current graphics context.
Declaration
func draw(with rect: NSRect, options: NSString.DrawingOptions = [])Parameters
- rect:
The rectangle specifies the rendering origin in the current graphics context.
- options:
The string drawing options. See Nsstringdrawingoptions for the available options.
Discussion
The rect argument’s origin field specifies the rendering origin. The point is interpreted as the baseline origin by default. With NSStringDrawingUsesLineFragmentOrigin, it is interpreted as the upper left corner of the line fragment rect. The size field specifies the text container size. The width part of the size field specifies the maximum line fragment width if larger than 0.0. The height defines the maximum size that can be occupied with text if larger than 0.0 and NSStringDrawingUsesLineFragmentOrigin is specified. If NSStringDrawingUsesLineFragmentOrigin is not specified, height is ignored and considered to be single-line rendering (NSLineBreakByWordWrapping and NSLineBreakByCharWrapping are treated as NSLineBreakByClipping).
You should only invoke this method when there is a current graphics context.