- Name
-
SetDisplayAttributes -- change attributes of current display (V4.5)
- Synopsis
-
SetDisplayAttributes(table)
- Function
-
This function can be used to change one or several window attributes of
the current display with a single function call. It is a very powerful
function that gives you the utmost flexibility for dealing with your
displays. Almost all attributes of the display can be changed on the
fly using this function. For example, you can make a display sizeable
or borderless with this function.
You have to pass a table containing a collection of attributes that
you want to modify to this function.
Here is a list of display attributes that you can modify using this
function:
BGPic:
-
Allows you to exchange the BGPic currently associated
with this display. This is basically the same as
calling DisplayBGPic(). The advantage of exchanging
BGPics with
SetDisplayAttributes()
is that you can
change other display attributes at the same time. To
exchange the BGPic for this display, simply pass the
identifier of the new BGPic in this tag.
Width, Height:
-
These allow you to change the dimensions of the current
display. This is the same as calling ChangeDisplaySize().
You can specify either a direct value of a string
containing a percentage specification (e.g "200%").
Starting with Hollywood 7.0 you can also set these tags to
the special constant
#NATIVE
. In that case, Hollywood will
use the dimensions of the display's host device.
X, Y:
-
Allows you to change the position of the current display.
This is the same as calling MoveDisplay(). You can either
specify a direct value or one of Hollywood's special
coordinate constants.
Title:
-
See DISPLAY for details.
Borderless:
-
See DISPLAY for details.
Sizeable:
-
See DISPLAY for details.
Fixed:
-
See DISPLAY for details.
NoHide:
-
See DISPLAY for details.
NoModeSwitch:
-
See DISPLAY for details.
NoClose:
-
See DISPLAY for details.
HidePointer:
-
See DISPLAY for details.
ScaleMode:
-
See DISPLAY for details.
ScaleWidth, ScaleHeight:
-
See DISPLAY for details.
SmoothScale:
-
See DISPLAY for details.
DragRegion:
-
See DISPLAY for details.
SizeRegion:
-
See DISPLAY for details.
PubScreen:
-
See DISPLAY for details. (V5.2)
FillStyle:
-
See DISPLAY for details. (V5.2)
Color:
-
See DISPLAY for details. (V5.2)
TextureBrush:
-
See DISPLAY for details. (V5.2)
TextureX, TextureY:
-
See DISPLAY for details. (V5.2)
GradientStyle:
-
See DISPLAY for details. (V5.2)
GradientAngle:
-
See DISPLAY for details. (V5.2)
GradientStartColor, GradientEndColor:
-
See DISPLAY for details. (V5.2)
GradientCenterX, GradientCenterY:
-
See DISPLAY for details. (V5.2)
GradientBalance:
-
See DISPLAY for details. (V5.2)
GradientBorder:
-
See DISPLAY for details. (V5.2)
GradientColors:
-
See DISPLAY for details. (V5.2)
HideFromTaskbar:
-
See DISPLAY for details. (V5.3)
HideOptionsMenu:
-
See DISPLAY for details. (V5.3)
Orientation:
-
See DISPLAY for details. (V5.3)
Menu:
-
This tag can be used to attach a menu strip to the current display. You have to pass the
identifier of a menu strip that has been created using the @MENU preprocessor
command or the CreateMenu() function to this tag. If you pass the special
value -1 here, the currently attached menu strip will be removed from the display.
See MENU for details. (V6.0)
Monitor:
-
See DISPLAY for details. (V6.0)
XServer:
-
See DISPLAY for details. (V6.0)
ScreenTitle:
-
See DISPLAY for details. (V6.0)
ScreenName:
-
See DISPLAY for details. (V6.0)
RememberPosition:
-
See DISPLAY for details. (V7.0)
HideTitleBar:
-
See DISPLAY for details. (V9.0)
ImmersiveMode:
-
See DISPLAY for details. (V9.0)
- Inputs
-
- table
- a table containing a collection of attributes that shall
be modified in the current BGPic; see the list above
- Example
-
SetDisplayAttributes({Borderless = True, Sizeable = True})
The code above makes the current display borderless and sizeable.