has-range-on-open

Arguments: outline-item

This outline-item property allows an outline-item to avoid displaying a leaf pixmap when a custom range-on-open method is expected to supply child items for it later when it is opened.

has-range-on-open returns nil by default, but may be set to true if needed by calling (setf has-range-on-open) or, more typically, by passing the :has-range-on-open initarg to make-instance when creating an outline-item.

An application should set this property to true if the item has no child items initially but a range-on-open method that the application has supplied for this outline is expected to return one or more child items for this item. If no custom range-on-open method is supplied for this outline, then there is no need to set the value of the has-range-on-open property.

An outline-item will display its outline-item-leaf-pixmap (rather than its outline-item-opened-pixmap or its outline-item-closed-pixmap) when it currently has no child items (that is, its range is nil) and when its has-range-on-open property is nil. Otherwise it will display its opened or closed pixmap, depending on its current state (assuming that draw-icons is enabled for the outline). The plus or minus pixmap is also displayed whenever the leaf pixmap is not displayed (assuming that draw-plus-minus is enabled for the outline).

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.