LockScreen

Applies to Windows and Windows Phone

Defines the badge and notifications that represent the app on the lock screen, which is shown when the system is locked.

Element hierarchy

<VisualElements>
<LockScreen>

Syntax

<LockScreen Notification = "badge" | "badgeAndTileText"
            BadgeLogo    = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. />

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
BadgeLogo

A logo image that is shown next to the badge to identify the app. This image must be monochromatic, of type .png, and measure 24 x 24 pixels.

For more info about how to specify the image in this attribute, see Remarks.

A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.Yes
Notification

The type of tile that can be shown for an app on the lock screen. This can either be simply a badge which displays either a number or a glyph to communicate status, or both a badge and text, which can display detailed status. If LockScreen Notification type 'badgeAndTileText' is selected, then the optional WideLogo must be specified, since only the WideLogo template provides the right information to display with tile text. If this image is not provided, the tile can only display in the square format and cannot accept notifications based on wide template types. This rule is semantically enforced through the manifest API.

This attribute can have one of the following values:

  • badge
  • badgeAndTileText
Yes

 

Child Elements

None.

Parent Elements

Parent ElementDescription
VisualElements

Describes the visual aspects of the Windows Store app: its default tile, logo images, text and background colors, initial screen orientation, splash screen, and lock screen tile appearance.

 

Remarks

For an app to have a presence on the lock screen, it must also register to handle background tasks. For more information, see the Lock screen overview and the BackgroundTasks element.

The BadgeLogo image can be given as either a direct path to an image file or as a resource. By using a resource reference, you can supply images of different scales so that Windows can choose the best size for the device and screen resolution. You can also supply high contrast images for accessibility and localized images to match different UI languages. For more info, see the Globalization and Localizing the package manifest topics.

Size requirements of a badge logo image are shown here:

Image attributeScaleImage size in pixels
Applications\Application\VisualElements\LockScreen\@BadgeLogo10024x24
14033x33
18043x43

 

See also

Lock screen overview
How to show notifications on the lock screen
Lock screen apps sample

Requirements

Namespace

http://schemas.microsoft.com/appx/2010/manifest

 

 

Show:
© 2014 Microsoft