NOSYSMENU Property

 

Enable or disable the Window System Menu

 

 

Description:

 

The NOSYSMENU Property can be used to enable or disable the Window system menu which also disables the minimize, maximize and close buttons.

 

The image below demonstrates a Window with the NOSYSMENU property set to true (.T.). Note that system menu, represented by an icon, the minimize, maximize and close buttons no longer appear on the titlebar

 

NoSysmenu Property

 

Syntax:

 

    THISWINDOW | <FormName>.NOSYSMENU --> lValue

 

    THISWINDOW | <FormName>.NOSYSMENU := lValue

Valid For Use With:

 

This Property is assumed to be available for use with all Window types

 

 

Notes:

  1. This property is only available after Window definition

  2. It is one of the newer properties which is intended to overcome a limitation with the SYSMENU property which can only be used during Window definition

  3. Important: The values used or returned by THISWINDOW | <FormName>.NOSYSMENU 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 system menu on or off), you do use the value that you would expect. Eg. to turn the system menu off, you would use THISWINDOW | <FormName>.NOSYSMENU := .T.

    • Finally, note that the value returned when using THISWINDOW | <FormName>.NOSYSMENU appears to be the opposite of the value that you would expect. so if you run THISWINDOW | <FormName>.NOSYSMENU := .T. and then run THISWINDOW | <FormName>.NOSYSMENU the value returned is actually .F.!

  4. 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 System Menu. 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

 

Sample Code:

 

Sample code to test this Property can be found here