PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • 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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Note: See Declaring a variable for more details.
Versions 21 and later
Universal Windows 10 App This type of variable is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This type of variable is now available in Universal Windows 10 App mode.
Universal Windows 10 App 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 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, see http://msdn.microsoft.com/en-us/library/windows/apps/hh465439.aspx for more details)
Notes:
  • 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):
WordwrapBoolean
  • True to automatically position the text on the next line according to the size of the tile,
  • False otherwise.
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. See theMicrosoft documentation at the following address for more details: http://msdn.microsoft.com/en-us/library/windows/apps/hh761491.aspx
Note: 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.
Note: If the title and the text are empty, only the image is displayed.
TypeInteger constantType of the tile. The available types are as follows:
Note: 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.
Minimum required version
  • Version 18
This page is also available for…
Comments
Click [Add] to post a comment