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.