Legacy Document

Inside Macintosh: Cyberdog Programmer's Kit / Part 3 - Cyberdog Reference

Chapter 7 - Classes and Methods / CyberItem

SetDefaultName

Sets the default display name for this Cyberdog item.

void SetDefaultName (in StringPtr defaultName,
in ScriptCode script);

defaultName

A pointer to a string buffer containing the new default name.

script

The script code of the default name string.

DISCUSSION

The default display name is used to refer to a Cyberdog item in the user interface. This method should make its own copy of the name string.

A Cyberdog item may call this method itself during the opening process once it determines what its display name should be. Cyberdog also calls this method rename Cyberdog items in the notebook.

Once initialized, a Cyberdog item should not be changed. If you need to change the default display name of a Cyberdog item, you should clone the Cyberdog item, call this method to change the name of the clone, and then replace the original item with the clone.

If you subclass CyberItem, you must override this method. Your override must not call its inherited method; that is, your override method must implement this method's functionality completely.

SEE ALSO

The GetStringProperty method (page 237).