Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version

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-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version