Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Collapse]Messages, Notifications and Dialogs
    XtraMessageBox
    Input Box
    XtraDialog
    Flyout Dialog
    Flyout Panel
   [Expand]Alert Windows
    Toast Notification Manager
    WinRTLiveTileManager
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

WinRTLiveTileManager

Important

The WinRTLiveTileManager component is compatible only with Windows 8 and Windows 8.1

Expanded Online Video

Expanded Concepts

The WinRTLiveTileManager component allows you to create Windows Forms applications that are fully compatible with the Microsoft Windows 8 OS. Use this component in your Windows Forms application to create Live Tile(s) for this app within the Windows 8 Start Screen.

The WinRTLiveTileManager component requires a separate DevExpress Live Tile Manager Windows Store application to be installed on machines of end-users. You can also install it on your machine for debug purposes. The DevExpress Live Tile Manager app can be easily found in the Microsoft Windows Store. This application serves as a bridge between the WinRTLiveTileManager WinForms component and the Windows 8 Start Screen. For end-users, this app provides a UI allowing them to pin and unpin Live Tiles created via the WinRTLiveTileManager component to/from the Windows 8 Start Screen:

A Live Tile consists of the following visual elements:

Expanded Getting Started

To use the WinRTLiveTileManager control, open your existing Windows Forms project, locate the WinRTLiveTileManager component in the Visual Studio toolbox and drop it onto the application form.

Assign the ContainerControl object that hosts the WinForms app (app module) to the WinRTLiveTileManager.ContainerControl property, to assosiate this app (module) with the WinRTLiveTileManager component. You can also specify the WinRTLiveTileManager.ApplicationName property to set the application name displayed within a corresponding Live Tile.

If you launch the application, and then switch to the DevExpress Live Tile Manager Windows Store app, you will see a Tile. This Tile can be pinned to the Windows 8 Start Screen, but it is static and not actually a 'Live' Tile yet. Live Tiles display real-time notifications related to the current application state when the application is running but not focused. To display these notifications, use the WinRTLiveTileManager.UpdateTile method. This method takes the WideTile and SquareTile objects as parameters. These objects contain Tile Templates for large and regular size Tiles respectively. The following code illustrates an example:

Note

All methods that create tiles are named after the corresponding tile templates mentioned above. You can refer to the Tile Template Catalog article, and use the corresponding methods to create a Tile of the desired type.

The image below illustrates an example of both Wide and Square Tile Templates, created via code above.

If you use a WideTile template for your Live Tile, you can pass null to the WinRTLiveTileManager.UpdateTile method instead of a SquareTile. But it's strongly recommended to pass both a WideTile and SquareTile objects when updating a Live Tile, because an end-user can manually resize a Tile by standard Windows 8 means (to do so, right-click a Live Tile to select it and clich the 'Larger' or 'Smaller' option from the Apps bar below).

You can optionally update a Live Tile's Badge when updating its content. The following code sets a 'New Message' badge for a Tile:

If your application has multiple modules, each of them containing a WinRTLiveTileManager component, and multiple Live Tiles are pinned to the Windows 8 Start Screen, you can get the Tile that an end-user clicked. To do so, call the WinRTLiveTileManager.InitializeNavigation method and handle the WinRTLiveTileManager.OnNavigated event, as shown below.

The obj parameter returns the related WinRTLiveTileManager ID (the WinRTLiveTileManager.Id property), so you can check the ID and get the Live Tile that was clicked. The ID for each WinRTLiveTileManager is generated automatically and cannot be modified.

How would you rate this topic?​​​​​​​