17.2 Specifying attribute values

As you have already seen, the Interface Builder assigns default names such as Row-Layout-1 to the elements you add to an interface; you usually want to replace these with your own names. In addition, there are probably titles that you want to add to the interface; you can see the default titles that have been created by looking at the interface skeleton. The next stage of the example shows you how to change these default names and titles.

Changing the name or title of an element is actually just a case of changing the value assigned to an attribute of that element, as described in Setting the attributes for the selected object. You would normally assign values to a number of different attributes at once, rather than concentrating on the names and titles of elements. The example is structured in this way to give you an idea of the sort of working practices you might find it useful to adopt when generating interface code.

To recap, the layout hierarchy of the example interface is shown in Layout hierarchy of the example interface. To ensure that you can understand this layout easily in the future, it is important to assign meaningful names and titles to the elements it contains now.

Figure 17.2 Layout hierarchy of the example interface

  1. Select the Interface-1 object and then use the Interface > Attributes menu item to show the attributes dialog.
  2. The Attributes dialog appears as shown in Attributes dialog for the example interface.

    Figure 17.3 Attributes dialog for the example interface

    Notice that the NAME attribute of the interface has the value INTERFACE-1 , and the TITLE attribute has the value "Interface-1" .

    Note: If this is not the first interface you have created in the current session, the number is different.

  3. Delete the value in the NAME text box, and type ib-example .
  4. Delete the value in the TITLE text box, and type "Example Interface" .
  5. Click OK to dismiss the Attributes dialog and update the interface.
  6. The name of the interface is now displayed as Ib-Example in the Layout hierarchy area, and the title of the interface skeleton changes to Example Interface .

    Note: Case is not significant in the NAME attribute, because it is a Common Lisp symbol, but it is significant in the TITLE attribute, which is a string.

  7. Select the Column-Layout-1 element. Double-click to display its Attributes dialog (you will now find this more convenient than using the Object > Attributes menu item). Change the value of its NAME attribute to main-layout and click OK .
  8. Now change the names of the other objects in the interface.

  9. Select the graph pane and change its NAME attribute to graph , and its INTERACTION attribute to :extended-selection . Click OK .
  10. Select the list panel and change its NAME attribute to list , and its INTERACTION attribute to :extended-selection . Do not click OK yet.
  11. The value of the INTERACTION attribute allows you to select several items from the list panel and the graph pane, using the appropriate method for your platform.

  12. Change the ITEMS attribute of the list panel to the following list of strings:
  13. '("One" "Two" "Three" "Four" "Five" "Six" "Seven" "Eight")
  14. Click OK .
  15. The row layout you created contains objects which are used solely to display information.

  16. Select the row layout object and change its NAME attribute to display-layout .
  17. Change the ADJUST attribute of the row layout to :center . Click OK .
  18. This value of the ADJUST attribute centers the title pane and the display pane vertically in the row layout, which ensures their texts line up along the same baseline.

    In the working example, the display-layout object is going to show information about the current selection, so you need to change the names and titles of the objects it contains accordingly.

  19. Select the title pane and change its NAME attribute to selection-title and its TEXT attribute to "Selection:" . Click OK .
  20. Select the display pane and change its NAME attribute to selection-text , and its TEXT attribute to "Displays current selection" . Click OK .
  21. This specifies a text string that is displayed when the interface is initially created. This string disappears as soon as you perform any action in the interface.

The layout hierarchy is now as shown in Layout hierarchy with names specified. The names that you have assigned to the different objects in the interface make the purpose of each element more obvious.

Figure 17.4 Layout hierarchy with names specified

Common LispWorks User Guide (Windows version) - 11 Apr 2005