Tile QML Type (Uncreatable)

The Tile represents an area on the screen that can contain windows. More...

Note: This is an uncreatable type. It cannot be instantiated in QML.

• List of all members, including inherited members

Properties

• absoluteGeometry : RectF
• absoluteGeometryInScreen : RectF
• canBeRemoved : bool
• isLayout : bool
• minimumSize : size
• padding : real
• parent : Tile
• positionInLayout : int
• relativeGeometry : RectF
• tiles : list<Tile>
• windows : list<Window>

Methods

• void manage(Window window)
• void resizeByPixels(real delta, enumeration edge)
• void unmanage(Window window)

Detailed Description

A tile may contain zero, one, or more windows. When a window is placed in a tile, it will fill the entire tile.

A tile may contain other tiles as children, in which case, the children sub-divide the space of the parent tile. Every screen per virtual desktop has a tile tree associated with it.

There are several types of tiles: QuickTile, a quick tiling implementation detail, and CustomTile. Tiling scripts operate with CustomTile tiles.

Property Documentation

absoluteGeometry : RectF

The geometry of the tile in pixels in the global coordinate space, i.e. 0,0 corresponds to the top-left corner of the bounding rectangle of all outputs.

absoluteGeometryInScreen : RectF

The geometry of the tile in pixels in the output-local coordinate space, i.e. 0,0 corresponds to the top-left corner of the output.

canBeRemoved : bool

Whether this Tile can be removed.

isLayout : bool

Whether this Tile is a layout Tile. In other words, a Tile that arranges its child Tiles in a special manner, e.g. from left to right, or top to bottom, etc.

minimumSize : size

The minimum size that the windows in this Tile can be resized to. In the logical pixels.

padding : real

The distance that should be maintained between tiles as well as away from the screen edges. The padding is specified in the logical pixels.

parent : Tile

The parent Tile of this Tile. This property can be null if this is the root Tile.

positionInLayout : int

If this Tile is a child of a layout Tile, this property specifies the child index of this Tile.

relativeGeometry : RectF

The geometry of the tile relative to the size of the associated output. The relative geometry is normalized. relativeGeometry.width of 1 corresponds to the width of the output.

tiles : list<Tile>

The child tiles.

windows : list<Window>

The managed windows.

Method Documentation

void manage(Window window)

Put the specified window to this tile. The window will be resized to match this tile.

If the window is in another tile, it will be evacuated from that tile before getting moved to this tile.

void resizeByPixels(real delta, enumeration edge)

Resize this tile by the given delta pixels along the specified edge. The tile size may be left unchanged due to size constraints, etc.

void unmanage(Window window)

Remove the specified window from this tile. The window will be resized to match its size before it was put in the tile.