Member variable XbpBrowse():useVisualStyle Foundation

Determines whether the object uses Visual Styles for display.

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

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:

Colors and frame styles used with :useVisualStyle == .T.
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.

Feedback

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.