NOCAPTION Property
Enables and disables the Window Titlebar
Description:
The NOCAPTION Property can be used to turn a Window's TITLEBAR on or off
The image below demonstrates a Window with the NOCAPTION property set to true(.T.)
Syntax:
THISWINDOW | <FormName>.NOCAPTION --> lValue
THISWINDOW | <FormName>.NOCAPTION := lValue
Valid For Use With:
This Property is assumed to be available for use with all Window types
Notes:
This property is only available after Window definition
It is one of the newer properties which is intended to overcome a limitation with the TITLEBAR property which can only be used during Window definition
Important: The values used or returned by THISWINDOW | <FormName>.NOCAPTION can easily be misunderstood!
Firstly, when you change the value the old value is not returned
Secondly, when you need to change the value (either turn the TITLEBAR on or off), you do use the value that you would expect. Eg. to turn a TITLEBAR off, you would use THISWINDOW | <FormName>.NOCAPTION := .T.
Finally, note that the value returned when using THISWINDOW | <FormName>.NOCAPTION appears to be the opposite of the value that you would expect. so if you run THISWINDOW | <FormName>.NOCAPTION := .T. and then run THISWINDOW | <FormName>.NOCAPTION the value returned is actually .F.!
To completely remove the top bar on the Window (see image above and compare to image below) NOSIZE should also be set to true
No help documentation was published with the original or subsequent releases of HMG
Properties:
The following Property is available after the Window has been defined
lValue | Logical | R, W | Gets / Sets a logical value to enable / disable the Window's title bar. Please refer to Note 3, above |
D - Properties of this type can be used when defining a Window
R - Properties of this type can only be accessed (read) after the Window has been defined
W - Properties of this type can be changed (write) after the Window has been defined
See GETPROPERTY and SETPROPERTY functions for further infomation on accessing or changing properties or use semi-OOP syntax
Additional Information:
The image below demonstrates a Window with the NOCAPTION and NOSIZE properties both set to true (.T.). Note that this has the effect of also removing the Windows border. This may be of use when creating a "splash" type screen