Tile (Type of variable)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Properties specific to the description of Tile variables
Displaying text and/or images
Square and rectangular tiles
Notes
Functions that are using the Tile variables

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Tile (Type of variable)

In french: Tuile

The Tile type is used to defined all the advanced characteristics of a tile for an application in Universal Windows 10 App mode. The characteristics of this tile can be defined and modified by several WLanguage properties.

Remark: See Declaring a variable for more details on the declaration of this type of variable and the use of WLanguage properties.

Versions 21 and later

This type of variable is now available in Universal Windows 10 App mode.

New in version 21

This type of variable is now available in Universal Windows 10 App mode.

Example

MyTile is Tile
MyTile..Type = tileWide
MyTile..Model = tileTemplateWideImageTop
Add(MyTile..Images, "photo.jpg")
MyTile..Text = "Important"
TileDeleteAll()
TileAdd(MyTile)

Remarks

Properties specific to the description of Tile variables

The following properties can be used to handle a tile:

Property name	Type used	Effect

Images	Array of character strings	List of access paths to the image (or to the images) displayed in the tile. The paths of images can be: URLs of "http://" type pointing to an image. A relative path in relation to the bundle of the application. A relative path in relation to the "appdata" directory of the application. The images are sought in the bundle then in the "appdata" directory. Caution: The images must be less than 1024*1024 pixels and less than 200 KB (Microsoft limitation, see http://msdn.microsoft.com/en-us/library/windows/apps/hh465439.aspx for more details) Remarks: The tile will not be displayed if the specified URL is not correct or if the image does not respect the limitations. If no image is specified, only the text (and possibly the header) are displayed.
Model	Integer constant	Preset model used to display the tile. The available models are as follows: tileTemplateBlock: The tile is displayed as a block (square mode and wide mode): tileTemplateScrolling: The "square" tile includes an image and a text. The text lines scroll (up to 4 lines). The "Wide" tile includes a large image and 4 small images. The text lines scroll (up to 4 lines). tileTemplateWideScrollingImageSide: Specific to the wide tiles. The "Wide" tile includes a large image and a small image positioned beside the text. The text lines scroll (up to 4 lines). tileTemplateWideImageSide: Specific to the wide tiles. The "Wide" tile includes a small image positioned beside the text. The text lines do not scroll. tileTemplateWideImageTop: Specific to the wide tiles. The "Wide" tile includes a large image positioned above the text. The text lines do not scroll. tileTemplateText: The tile contains text only (square mode and wide mode):
Wordwrap	Boolean	True to automatically position the text on the next line according to the size of the tile, False otherwise.
Text	Character string	Text of the tile. For a custom tile (..Type property corresponding to the tileCustom constant), this property corresponds to the XML code used to define the tile. See theMicrosoft documentation at the following address for more details: http://msdn.microsoft.com/en-us/library/windows/apps/hh761491.aspx Remark: If the title and the text are empty, only the image is displayed.
Title	Character string	Header of the text of the tile. This header is displayed on the first line of the text, in a font a little bit bigger than the one used for the text. Remark: If the title and the text are empty, only the image is displayed.
Type	Integer constant	Type of the tile. The available types are as follows: tileSquare: square tile. tileWide: rectangular tile. tileCustom: tile whose shape and display mode are defined by an XML code specified in ..Text. See theMicrosoft documentation at the following address for more details: http://msdn.microsoft.com/en-us/library/windows/apps/hh761491.aspx

Remark: These properties can be used with one of the following syntaxes:

<Variable name>..<Property name>
<Variable name>.<Property name>

Displaying text and/or images

If ..Image is empty, only the text (and possibly the title) are displayed.
On the contrary, if the title and the text are empty, only the image is displayed.

Square and rectangular tiles

The tiles can be both square and wide. The user chooses the display mode that suits him. In order for the tile to be properly displayed in the two modes, these two modes must be managed.

In this case, TileAdd must be used to add the two display modes of the tile.

For example:

// Tile in rectangular mode
MyTile is Tile
MyTile..Type = tileWide
MyTile..Model = tileTemplateWideImageTop
Add(MyTile..Images, "photo.jpg")
MyTile..Text = "My little text"
TileAdd(MyTile)

// Tile in square mode
MyTile..Type = tileSquare
MyTuile..Model = tileTemplateScrolling
TileAdd(MyTile)

Notes

Up to 5 different tiles can be scrolled in a queue.
The tiles can be updated even if the application is closed by specifying a URL in the XML description of tile.
You have the ability to add badges at the bottom of the tile with TileDisplayBadge.

Functions that are using the Tile variables


Versions 18 and later TileAdd New in version 18 TileAdd TileAdd	Adds a new tile customization for the current Windows Store Apps application.