RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TCustomActionManager.PrioritySchedule Property

Specifies a schedule that indicates how long it takes to mark an item as unused.

Pascal
property PrioritySchedule: TStringList;
C++
__property TStringList PrioritySchedule;

Based on usage statistics and layout space, the action manager uses PrioritySchedule to determine when a UI element representing a TActionClientItem is hidden or displayed on an action band. (This is not the same as the TActionClientItem's visibility, as set by the TActionClientItem's Visible property.)  

To determine when to display or hide a UI element that is rendered by the action band for a specific TActionClientItem, the action manager maintains a total count for each item of the total number of sessions, the session number it was used in, and the current session number. The number of sessions is defined as the number of times the application has been launched. 

To determine if an item should be displayed, the program looks up the value of UsageCount in the left hand column in PrioritySchedule. If UsageCount is greater than the maximum tabulated value, that maximum is used for calculation purposes. The corresponding value in the right hand column is the number of sessions an item can be unused before it becomes hidden. 

An action band will always show as many controls as it has space to show; the action band will wrap rows or columns, if necessary. TActionClientItems with their UsageCount property set to -1, will always be shown. You can use the UsageCount property to ensure that specific action band controls are always shown. 

The default PrioritySchedule is as follows:

Number of sessions in which the action band item was used 
Number of sessions the item will remain unhidden after its last use 
0, 1  
3  
2  
6  
3  
9  
4, 5  
12  
6 – 8  
17  
9 – 13  
23  
14 – 24  
29  
25 or more  
31  

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!