uap:LockScreen (Windows 10)
Defines the badge and notifications that represent the app on the lock screen, which is shown when the system is locked.
<uap:LockScreen Notification = 'A string that can have one of the following values: "badge" or "badgeAndTileText".' BadgeLogo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.' />
Attributes and elements
|Attribute||Description||Data type||Required||Default value|
|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.||A string that can have one of the following values: badge or badgeAndTileText.||Yes|
|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 with a value between 1 and 256 characters in length that ends with
|uap:VisualElements||Describes the visual aspects of the app: its default tile, logo images, text and background colors, initial screen orientation, splash screen, and lock screen tile appearance.|
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 uap: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 topic.
Size requirements of a badge logo image are shown here:
- Image attribute
- Image size in pixels
- Lock screen overview
- How to show notifications on the lock screen
- Lock screen apps sample
- Windows.ApplicationModel.LockScreen namespace
Submit and view feedback for