Advanced Search

Log In | Not a Member?

Contact ADC

Next Page > Hide TOC

NSFontManager Class Reference

Overview

NSFontManager is the center of activity for the font conversion system. It records the currently selected font, updates the Font panel and Font menu to reflect the selected font, initiates font changes, and converts fonts in response to requests from text-bearing objects. In a more prosaic role, NSFontManager can be queried for the fonts available to the application and for the particular attributes of a font, such as whether it’s condensed or extended.

You normally set up a font manager and the Font menu using Interface Builder. However, you can also do so programmatically by getting the shared font manager instance and having it create the standard Font menu at runtime:

NSFontManager *fontManager = [NSFontManager sharedFontManager];

NSMenu *fontMenu = [fontManager fontMenu:YES];

You can then add the Font menu to your application’s main menu. Once the Font menu is installed, your application automatically gains the functionality of both the Font menu and the Font panel.

As of Mac OS X version 10.3, font collections are managed by NSFontManager.

Tasks

Getting the Shared Font Manager

• + sharedFontManager

Changing the Default Font Conversion Classes

• + setFontManagerFactory:
• + setFontPanelFactory:

Getting Available Fonts

• – availableFonts
• – availableFontFamilies
• – availableFontNamesWithTraits:
• – availableMembersOfFontFamily:

Setting and Examining the Selected Font

• – setSelectedFont:isMultiple:
• – selectedFont
• – isMultiple
• – sendAction
• – localizedNameForFamily:face:

Sending Action Methods

• – addFontTrait:
• – removeFontTrait:
• – modifyFont:
• – modifyFontViaPanel:
• – orderFrontStylesPanel:
• – orderFrontFontPanel:

Converting Fonts Automatically

• – convertFont:
• – changeFont:  delegate method

Converting Fonts Manually

• – convertFont:toFace:
• – convertFont:toFamily:
• – convertFont:toHaveTrait:
• – convertFont:toNotHaveTrait:
• – convertFont:toSize:
• – convertWeight:ofFont:
• – currentFontAction
• – convertFontTraits:

Getting a Particular Font

• – fontWithFamily:traits:weight:size:

Examining Fonts

• – traitsOfFont:
• – fontNamed:hasTraits:
• – weightOfFont:

Managing the Font Panel and Font Menu

• – setEnabled:
• – isEnabled
• – fontManager:willIncludeFont:  delegate method
• – fontPanel:
• – setFontMenu:
• – fontMenu:

Setting the Delegate

• – setDelegate:
• – delegate

Accessing the Action Method

• – setAction:
• – action
• – setTarget:
• – target

Setting Attributes

• – setSelectedAttributes:isMultiple:
• – convertAttributes:

Working with Font Descriptors

• – availableFontNamesMatchingFontDescriptor:
• – collectionNames
• – fontDescriptorsInCollection:
• – addCollection:options:
• – removeCollection:
• – addFontDescriptors:toCollection:
• – removeFontDescriptor:fromCollection:

Class Methods

setFontManagerFactory:

Sets the class object used to create the font manager to the given class.

+ (void)setFontManagerFactory:(Class)aClass

Parameters

aClass

The new font manager factory class, which should be a subclass of NSFontManager.

Discussion

When the NSFontManager class object receives a sharedFontManager message, it creates an instance of aClass, if no instance already exists. Your font manager class should implement init as its designated initializer. The default font manager factory is NSFontManager.

This method must be invoked before your application’s main nib file is loaded, such as in the application delegate’s applicationWillFinishLaunching: method.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• + setFontPanelFactory:

Declared In

setFontPanelFactory:

Sets the class used to create the Font panel to the given class.

+ (void)setFontPanelFactory:(Class)factoryId

Parameters

factoryId

The new font panel factory class, which should be a subclass of NSFontPanel.

Discussion

Invoke this method before accessing the Font panel in any way, such as in the application delegate’s applicationWillFinishLaunching: method.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• + setFontManagerFactory:

Declared In

sharedFontManager

Returns the shared instance of the font manager for the application, creating it if necessary.

+ (NSFontManager *)sharedFontManager

Return Value

The shared font manager.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• + setFontManagerFactory:

Declared In

Instance Methods

action

Returns the action sent to the first responder when the user selects a new font from the Font panel or chooses a command from the Font menu.

- (SEL)action

Return Value

The selector for the action.

Discussion

The default action is changeFont:.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setAction:

Declared In

addCollection:options:

Adds a specified font collection to the font manager with a given set of options.

- (BOOL)addCollection:(NSString *)collectionName options:(NSInteger)collectionOptions

Parameters

collectionName

The collection to add.

collectionOptions

The option described in “Font Collection Mask”. This option is not yet implemented.

Return Value

YES if the font collection was successfully added; otherwise, NO.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – removeCollection:

Declared In

addFontDescriptors:toCollection:

Adds an array of font descriptors to the specified font collection.

- (void)addFontDescriptors:(NSArray *)descriptors toCollection:(NSString *)collectionName

Parameters

descriptors

The font descriptors to add.

collectionName

The font collection to which descriptors are added.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – removeFontDescriptor:fromCollection:

Declared In

addFontTrait:

This action method causes the receiver to send its action message up the responder chain.

- (void)addFontTrait:(id)sender

Parameters

sender

The control that sent the message.

Discussion

By default, the action message is changeFont:.

When a responder replies by providing a font to convert in a convertFont: message, the receiver converts the font by adding the trait specified by sender. This trait is determined by sending a tag message to sender and interpreting it as a font trait mask for a convertFont:toHaveTrait: message.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – removeFontTrait:
• – modifyFont:
• – modifyFontViaPanel:

Declared In

availableFontFamilies

Returns the names of the font families available in the system.

- (NSArray *)availableFontFamilies

Return Value

The names of the available font families.

Discussion

These fonts are in various system font directories.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – availableFontNamesWithTraits:
• – availableFonts

Declared In

availableFontNamesMatchingFontDescriptor:

Returns the names of the fonts that match the attributes in the given font descriptor.

- (NSArray *)availableFontNamesMatchingFontDescriptor:(NSFontDescriptor *)descriptor

Parameters

descriptor

The font descriptor whose attributes are matched.

Return Value

The names of the matching fonts.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

availableFontNamesWithTraits:

Returns the names of the fonts available in the system whose traits are described exactly by the given font trait mask (not the NSFont objects themselves).

- (NSArray *)availableFontNamesWithTraits:(NSFontTraitMask)fontTraitMask

Parameters

fontTraitMask

The font traits for which to return font names. You specify the desired traits by combining the font trait mask values described in “Constants” using the C bitwise OR operator.

Return Value

The names of the corresponding fonts.

Discussion

These fonts are in various system font directories.

If fontTraitMask is 0, this method returns all fonts that are neither italic nor bold. This result is the same one you’d get if fontTraitMask were NSUnitalicFontMask | NSUnboldFontMask.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – availableFontFamilies
• – availableFonts

Declared In

availableFonts

Returns the names of the fonts available in the system (not the NSFont objects themselves).

- (NSArray *)availableFonts

Return Value

The names of the available fonts.

Discussion

These fonts are in various system font directories.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – availableFontFamilies
• – availableFontNamesWithTraits:

Declared In

availableMembersOfFontFamily:

Returns an array with one entry for each available member of a font family.

- (NSArray *)availableMembersOfFontFamily:(NSString *)family

Parameters

family

The name of a font family, like one that availableFontFamilies returns.

Return Value

The available members of family. See the following discussion for a specific description.

Discussion

Each entry of the returned NSArray is another NSArray with four members, as follows:

• 0. The PostScript font name, as an NSString object.

• 1. The part of the font name used in the font panel that’s not the font name, as an NSString object. This value is not localized—for example, "Roman", "Italic", or "Bold".

• 2. The font’s weight, as an NSNumber.

• 3. The font’s traits, as an NSNumber.

The members of the family are arranged in the font panel order (narrowest to widest, lightest to boldest, plain to italic).

For example, if you call availableMembersOfFontFamily:@"Times", it might return an array like this:

(("Times-Roman", "Roman", 5, 4),

 ("Times-Italic", "Italic", 6, 5),

 ("Times-Bold", "Bold", 9, 2),

 ("Times-BoldItalic", "Bold Italic", 9, 3)

)

Availability

• Available in Mac OS X v10.0 and later.

Declared In

collectionNames

Returns the names of the currently loaded font collections.

- (NSArray *)collectionNames

Return Value

The names of the current font collections.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – fontDescriptorsInCollection:

Declared In

convertAttributes:

Converts attributes in response to an object initiating an attribute change, typically the Font panel or Font menu.

- (NSDictionary *)convertAttributes:(NSDictionary *)attributes

Parameters

attributes

The current attributes.

Return Value

The converted attributes, or attributes itself if the conversion isn’t possible.

Discussion

Attributes unused by the sender should not be changed or removed.

This method is usually invoked on the sender of changeAttributes:. See NSTextView for more information.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – setSelectedAttributes:isMultiple:

Declared In

convertFont:

Converts the given font according to the object that initiated a font change, typically the Font panel or Font menu.

- (NSFont *)convertFont:(NSFont *)aFont

Parameters

aFont

The font to convert.

Return Value

The converted font, or aFont itself if the conversion isn’t possible.

Discussion

This method is invoked in response to an action message such as addFontTrait: or modifyFontViaPanel:. These initiating methods cause the font manager to query the sender for the action to take and the traits to change. See “Converting Fonts Manually” for more information.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – convertFont:toFace:
• – convertFont:toFamily:
• – convertFont:toHaveTrait:
• – convertFont:toNotHaveTrait:
• – convertFont:toSize:
• – convertWeight:ofFont:

Declared In

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.

- (NSFont *)convertFont:(NSFont *)aFont toFace:(NSString *)typeface

Parameters

aFont

The font whose traits are matched.

typeface

The new typeface; a fully specified family-face name, such as Helvetica-BoldOblique or Times-Roman.

Return Value

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

Discussion

This method attempts to match the weight and posture of aFont as closely as possible. Italic is mapped to Oblique, for example. Weights are mapped based on an approximate numeric scale of 0 to 15.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – convertFont:toFamily:
• – convertFont:toHaveTrait:
• – convertFont:toNotHaveTrait:
• – convertFont:toSize:
• – convertWeight:ofFont:
• – convertFont:

Declared In

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.

- (NSFont *)convertFont:(NSFont *)aFont toFamily:(NSString *)family

Parameters

aFont

The font whose traits are matched.

family

The new font famliy; a generic font name, such as Helvetica or Times.

Return Value

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

Discussion

This method attempts to match the weight and posture of aFont as closely as possible. Italic is mapped to Oblique, for example. Weights are mapped based on an approximate numeric scale of 0 to 15.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – convertFont:toFace:
• – convertFont:toHaveTrait:
• – convertFont:toNotHaveTrait:
• – convertFont:toSize:
• – convertWeight:ofFont:
• – convertFont:

Declared In

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.

- (NSFont *)convertFont:(NSFont *)aFont toHaveTrait:(NSFontTraitMask)fontTrait

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.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – convertFont:toNotHaveTrait:
• – convertFont:toFace:
• – convertFont:toFamily:
• – convertFont:toSize:
• – convertWeight:ofFont:
• – convertFont:

Declared In

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.

- (NSFont *)convertFont:(NSFont *)aFont toNotHaveTrait:(NSFontTraitMask)fontTraitMask

Parameters

aFont

The font whose traits are matched.

fontTraitMask

The mask for the traits to remove, created using the C bitwise OR operator to combine the traits described in “Constants.” Using NSUnboldFontMask or NSUnitalicFontMask removes the bold or italic trait, respectively.

Return Value

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

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – convertFont:toHaveTrait:
• – convertFont:toFace:
• – convertFont:toFamily:
• – convertFont:toSize:
• – convertWeight:ofFont:
• – convertFont:

Declared In

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.

- (NSFont *)convertFont:(NSFont *)aFont toSize:(CGFloat)size

Parameters

aFont

The font whose traits are matched.

size

The new font size.

Return Value

A font with matching traits except in the new size, or aFont if it can’t be converted.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – convertFont:toFace:
• – convertFont:toFamily:
• – convertFont:toHaveTrait:
• – convertFont:toNotHaveTrait:
• – convertWeight:ofFont:
• – convertFont:

Declared In

convertFontTraits:

Converts font traits to a new traits mask value.

- (NSFontTraitMask)convertFontTraits:(NSFontTraitMask)traits

Parameters

traits

The current font traits.

Return Value

The new traits mask value to be used by convertFont:.

Discussion

This method is intended to be invoked to query the font traits while the action message (usually changeFont:) is being invoked when the current font action is either NSAddTraitFontAction or NSRemoveTraitFontAction.

Availability

• Available in Mac OS X v10.5 and later.

Declared In

convertWeight:ofFont:

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

- (NSFont *)convertWeight:(BOOL)increaseFlag ofFont:(NSFont *)aFont

Parameters

increaseFlag

If YES, a heavier font is returned; if it’s NO, a lighter font is returned.

aFont

The font whose weight is increased or decreased.

Return Value

A font with matching traits except for the new weight, or aFont if it can’t be converted.

Discussion

Weights are graded along the following scale. The list on the left gives Apple’s terminology, and the list on the right gives the ISO equivalents. Names on the same line are treated as identical:

The NSFontManager implementation of this method refuses to convert a font’s weight if it can’t maintain all other traits, such as italic and condensed. You might wish to override this method to allow a looser interpretation of weight conversion.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – convertFont:toFace:
• – convertFont:toFamily:
• – convertFont:toHaveTrait:
• – convertFont:toNotHaveTrait:
• – convertFont:toSize:
• – convertFont:

Declared In

currentFontAction

Returns the current font conversion action.

- (NSFontAction)currentFontAction

Return Value

The current font action used by the convertFont: method.

Discussion

This method is intended to be invoked to query the font conversion action while the action message (usually changeFont:) is being invoked.

Availability

• Available in Mac OS X v10.5 and later.

Declared In

delegate

Returns the receiver’s delegate.

- (id)delegate

Return Value

The receiver’s delegate.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setDelegate:

Declared In

fontDescriptorsInCollection:

Returns an array of the font descriptors in the collection specified by the given collection name.

- (NSArray *)fontDescriptorsInCollection:(NSString *)collectionName

Parameters

collectionName

The font collection for which to return descriptors.

Return Value

The font descriptors.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – collectionNames

Declared In

fontMenu:

Returns the menu that’s hooked up to the font conversion system, optionally creating it if necessary.

- (NSMenu *)fontMenu:(BOOL)createFlag

Parameters

createFlag

If YES, the menu object is created if necessary; if NO, it is not.

Return Value

The font conversion system menu.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setFontMenu:

Declared In

fontNamed:hasTraits:

Indicates whether the given font has all the specified traits.

- (BOOL)fontNamed:(NSString *)typeface hasTraits:(NSFontTraitMask)fontTraitMask

Parameters

typeface

The name of the font.

fontTraitMask

The font traits to test, specified by combining the font trait mask values described in “Constants” using the C bitwise OR operator.

Return Value

YES if the font named typeface has all the traits specified in fontTraitMask; NO if it doesn’t.

Discussion

Using NSUnboldFontMask returns YES if the font is not bold, NO otherwise. Using NSUnitalicFontMask returns YES if the font is not italic, NO otherwise.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

fontPanel:

Returns the application’s shared Font panel object, optionally creating it if necessary.

- (NSFontPanel *)fontPanel:(BOOL)createFlag

Parameters

createFlag

If YES, the Font panel object is created if necessary; if NO, it is not.

Return Value

The application’s shared Font panel object.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• + sharedFontPanel (NSFontPanel)
• + sharedFontPanelExists (NSFontPanel)
• + setFontPanelFactory:

Declared In

fontWithFamily:traits:weight:size:

Attempts to load a font with the specified characteristics.

- (NSFont *)fontWithFamily:(NSString *)family traits:(NSFontTraitMask)fontTraitMask weight:(NSInteger)weight size:(CGFloat)size

Parameters

family

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

fontTraitMask

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.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

isEnabled

Indicates whether the font conversion system’s user interface items (the Font panel and Font menu items) are enabled.

- (BOOL)isEnabled

Return Value

YES if the font conversion system’s user interface items (the Font panel and Font menu items) are enabled; NO if they’re not.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – isEnabled (NSFontPanel)
• – isEnabled (NSMenuItem)
• – setEnabled:

Declared In

isMultiple

Indicates whether the last font selection recorded has multiple fonts.

- (BOOL)isMultiple

Return Value

YES if the last font selection recorded has multiple fonts; NO if it’s a single font.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setSelectedFont:isMultiple:
• – selectedFont

Declared In

localizedNameForFamily:face:

Returns a localized string with the name of the specified font family and face, if one exists.

- (NSString *)localizedNameForFamily:(NSString *)family face:(NSString *)face

Parameters

family

The font family, for example, @"Times".

face

The font face, for example, @"Roman".

Return Value

A localized string with the name of the specified font family and face, or, if face is nil, the font family only.

Discussion

The user’s locale is determined from the user’s NSLanguages default setting. The method also loads the localized strings for the font, if they aren’t already loaded.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

modifyFont:

This action method causes the receiver to send its action message up the responder chain.

- (void)modifyFont:(id)sender

Parameters

sender

The control that sent the message.

Discussion

By default, the action message is changeFont:.

When a responder replies by providing a font to convert in a convertFont: message, the receiver converts the font in the manner specified by sender. The conversion is determined by sending a tag message to sender and invoking a corresponding method:

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – addFontTrait:
• – removeFontTrait:
• – modifyFontViaPanel:

Declared In

modifyFontViaPanel:

This action method causes the receiver to send its action message up the responder chain.

- (void)modifyFontViaPanel:(id)sender

Parameters

sender

The control that sent the message.

Discussion

By default, the action message is changeFont:.

When a responder replies by providing a font to convert in a convertFont: message, the receiver converts the font by sending a panelConvertFont: message to the Font panel. The panel in turn may send convertFont:toFamily:, convertFont:toHaveTrait:, and other specific conversion methods to make its change.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – addFontTrait:
• – removeFontTrait:
• – modifyFont:

Declared In

orderFrontFontPanel:

This action method opens the Font panel by sending it an orderFront: message, creating the Font panel if necessary.

- (void)orderFrontFontPanel:(id)sender

Parameters

sender

The control that sent the message.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – fontPanel:
• + setFontPanelFactory:

Declared In

orderFrontStylesPanel:

This action method opens the Font styles panel.

- (void)orderFrontStylesPanel:(id)sender

Parameters

sender

The control that sent the message.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

removeCollection:

Removes the specified font collection.

- (BOOL)removeCollection:(NSString *)collectionName

Parameters

collectionName

The collection to remove.

Return Value

YES if the font collection was successfully removed; otherwise, NO.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – addCollection:options:

Declared In

removeFontDescriptor:fromCollection:

Removes the specified font descriptor from the specified collection.

- (void)removeFontDescriptor:(NSFontDescriptor *)descriptor fromCollection:(NSString *)collection

Parameters

descriptor

The font descriptor to remove.

collection

The font collection from which to remove the descriptor.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – addFontDescriptors:toCollection:

Declared In

removeFontTrait:

This action method causes the receiver to send its action message up the responder chain.

- (void)removeFontTrait:(id)sender

Parameters

sender

The control that sent the message.

Discussion

By default, the action message is changeFont:.

When a responder replies by providing a font to convert in a convertFont: message, the receiver converts the font by removing the trait specified by sender. This trait is determined by sending a tag message to sender and interpreting it as a font trait mask for a convertFont:toNotHaveTrait: message.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – addFontTrait:
• – modifyFont:
• – modifyFontViaPanel:

Declared In

selectedFont

Returns the last font recorded.

- (NSFont *)selectedFont

Return Value

The last font recorded with a setSelectedFont:isMultiple: message

Discussion

While fonts are being converted in response to a convertFont: message, you can determine the font selected in the Font panel like this:

NSFontManager *fontManager = [NSFontManager sharedFontManager];

panelFont = [fontManager convertFont:[fontManager selectedFont]];

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – isMultiple

Declared In

sendAction

Sends the receiver’s action message up the responder chain, initiating a font change for whatever conversion and trait to change were last requested.

- (BOOL)sendAction

Return Value

YES if some object handled the changeFont: message; NO if the message went unheard.

Discussion

By default, the receiver’s action message is changeFont:.

This method is used internally by the font conversion system. You should never need to invoke it directly. Instead, use the action methods such as addFontTrait: or modifyFontViaPanel:.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setAction:

Declared In

setAction:

Sets the action that’s sent to the first responder, when the user selects a new font from the Font panel or chooses a command from the Font menu, to the given selector.

- (void)setAction:(SEL)aSelector

Parameters

aSelector

The selector to set.

Discussion

The default action is changeFont:. You should rarely need to change this setting.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – action

Declared In

setDelegate:

Sets the receiver’s delegate to the given object.

- (void)setDelegate:(id)anObject

Parameters

anObject

The new delegate.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – delegate

Declared In

setEnabled:

Controls whether the font conversion system’s user interface items (the Font panel and Font menu items) are enabled.

- (void)setEnabled:(BOOL)flag

Parameters

flag

If YES, they’re enabled; if NO, they’re disabled.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setEnabled: (NSFontPanel)
• – isEnabled

Declared In

setFontMenu:

Records the given menu as the application’s Font menu.

- (void)setFontMenu:(NSMenu *)aMenu

Parameters

aMenu

The new Font menu.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – fontMenu:

Declared In

setSelectedAttributes:isMultiple:

Informs the paragraph and character formatting panels when text in a selection has changed attributes.

- (void)setSelectedAttributes:(NSDictionary *)attributes isMultiple:(BOOL)flag

Parameters

attributes

The new attributes.

flag

If YES, informs the panel that multiple fonts or attributes are enclosed within the selection.

Discussion

This method is used primarily by NSTextView.

Availability

• Available in Mac OS X v10.3 and later.

See Also

• – convertAttributes:

Declared In