Temporarily Overriding Object Captions
Applies to: WINDOWS only.
The Framework Manager’s avOverrideCaptions method allows you to temporarily override the captions associated with Applications, Views, Business Objects or Commands.
You can use this feature to show additional information about the state of an object in its caption, for example by indicating a count of how many associated messages exist or how many open orders were found.
Objects are identified by their unique system or user assigned User Object Name / Type found on their Identification tab:
For example this code changes the basic caption of the DEMO application:
Invoke Method(#avFrameworkmanager.avOverrideCaptions) Ofuserobjecttype(DEMO) Caption('HR Demo Application (5 messages)') Fim(#Fim)
Which causes the shipped DEMO application’s caption to change from this:
To this:
Some things worth knowing:
- Caption overrides are not persistent. When a VLF window is closed the overrides are lost.
- Caption overrides apply everywhere (and only) within the scope of the window that issues the change request.
- Changing the alphabetical position of a caption may or may not change its relative position.
The parameters of the avOverrideCaptions method are:
OfUserObjectType |
The unique system or user assigned type that identifies the object. |
Caption |
The new caption to be applied to the object. |
CaptionSingular |
The new singular caption to be applied to the object. This caption may not apply to all object types. |
CaptionAccel |
The new caption with an accelerator to be applied to the object. This caption may not apply to all object types. |
FIM |
The framework instance manager that identifies your window. Always pass as FIM(#FIM). |