share-image-lists

Arguments: list-view

This function returns a boolean value indicating whether the image-lists used by a list-view control will remain open when the list-view's pane is closed by either removing the list-view from its dialog or by closing the dialog. If nil, then any image-lists that were the value of the small-image-list, large-image-list, and state-image-list properties of the list-view will be closed when the list-view's pane is closed. If t (the default), then the image-lists will not be closed.

Since Common Graphics automatically opens a closed image-list when it is assigned to a list-view control, the desirable value of this property is basically a matter of efficiency. If an image-list is shared by multiple list-views that are created and destroyed at different times, then it is probably best to leave this property turned on in list-views that use the shared image-list to avoid the needless closing and re-opening of the image list. But if each list-view uses its own image-list, it may be desirable to turn this property off so that the memory or Windows resources consumed by the image lists of a list-view is automatically freed up when the list-view window is closed.

See list-view.

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