win8_livetile_notification_tag

Set the "tag" for the Live Tile.

Syntax:

GML Code Example

win8_livetile_notification_tag(tag);


Argument Description
tag The name "tag" of the notification.


Returns: N/A


Description

The tag is a string that you assign to the Live tile notification as a means to identify it later. Should you need to replace a Live Tile, or update it with another template or image, you would formulate another notification push (starting with the function win8_livetile_notification_begin) and use the same tag as in this function as that which you wish to change/replace.

You must have activated queuing with the function win8_livetile_queue_enable for this to function to be of any use as without queuing enabled, no matter what tag you use, any Live Tile notifications will overwrite the current Live tile rather than add a new one to the queue or modify an already queued one.

NOTE: This function can also apply to Secondary tiles when used along with win8_livetile_notification_secondary_begin.


Example:

GML Code Example

var expiryTime;
 expiryTime = date_current_datetime();
 expiryTime = date_inc_minute(expiryTime, 5);
 win8_livetile_notification_begin("TileSquarePeekImageAndText01");
 win8_livetile_notification_expiry(expiryTime);
 win8_livetile_notification_tag("tag0");
 win8_livetile_notification_text_add("Current Score = " + string(score));
 win8_livetile_notification_image_add("ms-appx:///" + working_directory + "ScoreTile.png");
 win8_livetile_notification_end();
 

The above code will push a new Live Tile notification through to Windows 8, with some text and an image, and the tile will be shown for 5 minutes.





No Examples Submitted

Does this page need better examples? Be the first to Submit

No Edits Suggested

Is this page unclear or not descriptive enough? Suggest an edit to the page and with enough upvotes your changes will be made.

No Questions Have Been Ask

Do you have a question about this page? Ask it Here