Member variable XbpCrt():useVisualStyle Foundation

Determines whether the XbpCrt object uses a Visual Style for display.

Attribute: EXPORTED
Data type: Logical (.T.)

The instance variable :useVisualStyle determines whether the Crt object uses a Visual Style to render its imagery. A Visual Style is a specification in the operating system that defines the visual appearance of an Xbase Part. Changing a Visual Style usually affects the way text, colors or borders appear on the screen. Per default, all XbpCrt objects use the Visual Style defined for dialog windows, if one is defined by the operating system. If the value .F. (FALSE) is assigned to :useVisualStyle, a compatible display method is used instead. In this case, the Crt object appears is if it was created on an older operating system version, or if Classic Display was selected in Control Panel.

Windows is usually installed with one or more Visual Style specifications which are selectable via the Control Panel application. Examples for such a specification is the Luna style under Windows XP, or the Aero style under Windows Vista. Note than when referring to the system-wide style setting, the term "Theme" is often used interchangeably with Visual Style.

Visual Styles are only available on computers running an operating system version of Windows XP or newer. In addition, a manifest must be defined application in order for Visual Styles to be available. On older platforms, the :useVisualStyle instance variable has no effect. See the function IsThemeActive() for further information.


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.