Copyright ã1995 by NeXT Computer, Inc.  All Rights Reserved.

IODisplayInspector

Inherits From:	IODeviceInspector : Object

Conforms To:	IOConfigurationInspector

Declared In:	driverkit/IODisplayInspector.h

Class Description

This class provides inspectors used by the Configure application for all displays. It provides an accessory View to IODeviceInspector that displays the current display mode and has a button. When the button is clicked, the IODisplayInspector puts up a panel that lets the user select the display mode for the device.

The panel shows all display modes specified for the ªDisplayModesº key in the driver bundle's Language.lproj/Localizable.strings file. The mode that's selected is placed in the device's Instancen.table file as the value of the ªDisplay Modeº key.

Instance Variables

id displayAccessoryHolder;

id displayMode;

id panel;

id modes;

id okButton;

id selectButton;

id modeText;

IODisplayMode *modeRecs;

unsigned int modeCount;

displayAccessoryHolder	The View where the display inspector's own accessory View (as opposed to the IODeviceInspector's accessory View) is placed

displayMode	The accessory View provided to the IODeviceInspector

panel	The Select Display Mode panel

modes	The DBTableView where valid display modes are listed and can be selected

okButton	The OK button in panel

selectButton	The Select button in displayMode

modeText	The text in displayMode that shows the current display mode

modeRecs	An array of IODisplayModes, initialized during setTable: with the modes specified in the device's Default.table

modeCount	The number of IODisplayModes in modeRecs

Method Types

Initializing the IODisplayInspector
- init

Setting attributes	- setAccessoryView:
- setTable:

Displaying the Select Display Mode panel
- runPanel:
- panelDone:

Target and Action methods	- cancel:
- doubleClicked:

Instance Methods

cancel:

- cancel:sender 

Exits the Select Display Modes panel without changing the current display mode. Returns self.

See also:  - runPanel:

doubleClicked:

- doubleClicked:sender 

Clicks the OK button in the Select Display Modes panel. This method is invoked when the user double-clicks an item in the display modes DBTableView. Returns self.

See also:  - panelDone:

init

- init

Initializes and returns a newly allocated IODisplayInspector. Returns nil and frees itself if an error occurs.

panelDone:

- panelDone:sender 

Dismisses the Select Display Modes panel. This method is invoked when the user clicks the panel's OK button. Returns self.

See also:  - runPanel:

runPanel:

- runPanel:sender 

Runs the Select Display Modes panel in a modal loop. Before displaying the panel, this method reads the supported display modes from the driver bundle's Localizable.strings file, puts the modes in the panel's DBTableView, and selects the current mode. When the user clicks the Cancel or OK button the loop is broken, the panel is hidden, and, if the button was OK, the new display mode is written to the driver's configuration table. Returns self.

See also:  - cancel:, - panelDone:

setAccessoryView:

- setAccessoryView:aView 

Sets the IODisplayInspector's accessory View to aView. Because IODisplayInspector's inspector View is implemented as IODeviceInspector's accessory View, aView is an accessory View within an accessory View. Use this method to add a device-specific View to the inspector. Returns self.

setTable:

- setTable:(NXStringTable *)instanceTable 

Specifies instanceTable as the configuration table associated with this device and uses the value of instanceTable's ªDisplay Modeº key to initialize the display modes for this device. The data in instanceTable is written out to its corresponding file (Instancen.table) when the user saves the configuration. 

The Configure application invokes this method whenever the user selects this device for inspection. Returns self.