Class

NSPrintPanel

The Print panel that queries the user for information about a print job.

Declaration

@interface NSPrintPanel : NSObject

Overview

A Print panel may let the user select the range of pages to print and the number of copies before executing the Print command. Print panels can display a simplified interface when printing certain types of data. For example, the panel can display a list of print-setting presets, which lets the user enable print settings in groups as opposed to individually. Assigning an appropriate string to the jobStyleHint property activates the simplified interface and identifies which presets to display.

Topics

Creating an NSPrintPanel

+ printPanel

Returns a new NSPrintPanel object.

Customizing the Panel

jobStyleHint

The type of settings that the print panel displays.

NSPrintPanelJobStyleHint

Constants to be used as job style hints for activating the simplified Print panel interface and setting the options to display.

options

The current configuration options for the Print panel.

NSPrintPanelOptions

These constants are used to configure the contents of the main Print panel.

- defaultButtonTitle

Returns the title of the Print panel’s default button.

- setDefaultButtonTitle:

Sets the title of the Print panel’s default button.

helpAnchor

The HTML help anchor associated with the Print panel.

Managing Accessory Views

- addAccessoryController:

Adds a custom controller to the Print panel to manage an accessory view.

- removeAccessoryController:

Removes the specified controller and accessory view from the Print panel.

NSPrintPanelAccessorizing

A set of methods that a print panel object can use to get information from a printing accessory controller.

accessoryControllers

The array of controller objects that manage the Print panel’s accessory views.

Running the Panel

- beginSheetWithPrintInfo:modalForWindow:delegate:didEndSelector:contextInfo:

Displays a Print panel sheet and runs it modally for the specified window.

- runModal

Displays the receiver's Print panel and begins the modal loop.

- runModalWithPrintInfo:

Displays the receiver’s Print panel and runs the modal loop using the specified printing information.

Communicating with the NSPrintInfo Object

printInfo

The printing information associated with the running Print panel.

- updateFromPrintInfo

Updates the receiver with information from the current NSPrintOperation object.

Deprecated
- finalWritePrintInfo

Writes the receiver's printing attributes to the current NSPrintOperation object.

Deprecated

Deprecated Methods

- accessoryView

Returns the accessory view of the receiver.

Deprecated
- setAccessoryView:

Sets the accessory view for the receiver.

Deprecated
- pickedButton:

Deprecated.

Relationships

Inherits From

See Also

Print Panels

NSPageLayout

A panel that queries the user for information such as paper type and orientation.