Xojo Documentation Xojo Documentation

Read-Only Property (As Boolean )

BooleanValue = aWindow.HasFullScreenButton

New in 2019r2

Supported for all project types and targets.

When set to True, the window control to enable macOS full screen mode is displayed.

Notes

This property can only be changed at design-time.

Clicking the control enables the macOS native full screen mode. This property has no effect on Windows or Linux.

In order to test if the user is running in the native full screen mode you should check both full screen properties:

If Self.HasFullScreenButton And Self.FullScreen Then
// User is in native full screen mode
End If

When HasFullScreenButton is False, setting FullScreen to True cause the Window to fill the screen although not using the native full screen mode so the behavior will be different.

Starting with macOS 10.11 (El Capitan), the Maximize button is treated as a full screen button. You do not have to specifically set HasFullScreenButton to True. In order for the user to maximize a window rather than put it into Full Screen Mode, they should Option-Click on the Maximize button or double-click the title bar.