Vcl.ActnMan.TCustomActionManager.PrioritySchedule
Delphi
property PrioritySchedule: TStringList read FPrioritySchedule write SetPrioritySchedule stored IsPriorityScheduleStored;
C++
__property System::Classes::TStringList* PrioritySchedule = {read=FPrioritySchedule, write=SetPrioritySchedule, stored=IsPriorityScheduleStored};
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| property | public | Vcl.ActnMan.pas Vcl.ActnMan.hpp |
Vcl.ActnMan | TCustomActionManager |
Description
Specifies a schedule that indicates how long it takes to mark an item as unused.
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 |