Member variable XbpBrowse():useVisualStyle Foundation
Determines whether the object uses Visual Styles for display.
The instance variable :useVisualStyle determines whether the browser uses Visual Styles to render its imagery. A Visual Style is a specification in the operating system that defines the visual appearance of an Xbase Part. If .T. (true) is assigned to :useVisualStyle, the browser configures itself to use a combination of system colors similar to those used by Windows Explorer. In addition, Visual Styles are used to display certain elements within the browser object, such as the column headers. This mode ensures that the XbpBrowse object integrates well with other user interface elements. Note that the general appearance of the user interface may be significantly different if the system-global theme is changed by the user in Control Panel.
Creating an XbpBrowse object with a value of .T. in member :useVisualStyle causes the following colors and frame styles to be selected on platforms running Windows XP or newer:
Column area | Display setting |
---|---|
:Heading | Frame style: XBPFRAME_NONE |
:DataArea | Foreground color: XBPSYSCLR_HILITEFOREGROUND |
Background color: XBPSYSCLR_WINDOW | |
Hilite fg. color: XBPSYSCLR_HILITEFOREGROUND | |
Hilite bg. color: XBPSYSCLR_HILITEBACKGROUND | |
Frame style: XBPFRAME_NONE | |
Cell frame style: XBPFRAME_BOX | |
Hilite frame style: XBPFRAME_BOX | |
:Footing | Background color: XBPSYSCLR_DIALOGBACKGROUND |
Frame style: XBPFRAME_BOX+XBPFRAME_RECT |
If the application needs to exert full control over the way a browser is displayed, the value .F. (false) must be assigned to :useVisualStyle. See member XbpWindow:useVisualStylefor further information.
Visual Styles are only available on computers running an operating system version of Windows XP or newer. In addition, a manifest must be defined 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.