ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Tile functions
  • Properties specific to Tile variables
  • Displaying text and/or images
  • Square and rectangular tiles
  • Notes
  • Functions that are using the Tile variables
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
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 Tile variables

The following properties can be used to handle a tile:
Property nameType usedEffect
ImagesArray of character stringsList 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, for more details, see http://msdn.microsoft.com/en-us/library/windows/apps/hh465439.aspx)
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.
ModelInteger constantPreset 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):
TextCharacter stringText 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. For more details, see theMicrosoft documentation at the following address: 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.
TitleCharacter stringHeader 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.
TypeInteger constantType of the tile. The available types are as follows:
WordwrapBoolean
  • True to automatically position the text on the next line according to the size of the tile,
  • False otherwise.

Displaying text and/or images

  • If the Image property 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

TileAddAdds a new tile customization for the current Windows Store Apps application.
Minimum version required
  • Version 18
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/26/2023

Send a report | Local help