|
|
@@ -1,224 +0,0 @@
|
|
|
-// ******************************************************************
|
|
|
-// Copyright (c) Microsoft. All rights reserved.
|
|
|
-// This code is licensed under the MIT License (MIT).
|
|
|
-// THE CODE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
|
|
|
-// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
|
-// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
|
|
|
-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
|
-// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
|
|
|
-// THE CODE OR THE USE OR OTHER DEALINGS IN THE CODE.
|
|
|
-// ******************************************************************
|
|
|
-
|
|
|
-using System;
|
|
|
-using System.Linq;
|
|
|
-using Microsoft.Toolkit.Uwp.Notifications.Adaptive.Elements;
|
|
|
-
|
|
|
-namespace Microsoft.Toolkit.Uwp.Notifications
|
|
|
-{
|
|
|
- /// <summary>
|
|
|
- /// Contains multiple binding child elements, each of which defines a Tile.
|
|
|
- /// </summary>
|
|
|
- public sealed class TileVisual
|
|
|
- {
|
|
|
- /// <summary>
|
|
|
- /// The target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". This locale is overridden by any locale specified in binding or text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string.
|
|
|
- /// </summary>
|
|
|
- public string Language { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// A default base URI that is combined with relative URIs in image source attributes.
|
|
|
- /// </summary>
|
|
|
- public Uri BaseUri { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// The form that the Tile should use to display the app's brand.
|
|
|
- /// </summary>
|
|
|
- public TileBranding Branding { get; set; } = Element_TileVisual.DEFAULT_BRANDING;
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// Defaults to false. Set to true to allow Windows to append a query string to the image URI supplied in the Tile notification. Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. This query string specifies scale, contrast setting, and language; for instance, a value of
|
|
|
- ///
|
|
|
- /// "www.website.com/images/hello.png"
|
|
|
- ///
|
|
|
- /// included in the notification becomes
|
|
|
- ///
|
|
|
- /// "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
|
|
|
- /// </summary>
|
|
|
- public bool? AddImageQuery { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// Set to a sender-defined string that uniquely identifies the content of the notification. This prevents duplicates in the situation where a large Tile template is displaying the last three wide Tile notifications.
|
|
|
- /// </summary>
|
|
|
- public string ContentId { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// An optional string to override the Tile's display name while showing this notification.
|
|
|
- /// </summary>
|
|
|
- public string DisplayName { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// If you specify this, you must also provide a Wide Tile binding. This is the first line of text that will be displayed on the lock screen if the user has selected your Tile as their detailed status app.
|
|
|
- /// </summary>
|
|
|
- public string LockDetailedStatus1 { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// If you specify this, you must also provide a Wide Tile binding. This is the second line of text that will be displayed on the lock screen if the user has selected your Tile as their detailed status app.
|
|
|
- /// </summary>
|
|
|
- public string LockDetailedStatus2 { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// If you specify this, you must also provide a Wide Tile binding. This is the third line of text that will be displayed on the lock screen if the user has selected your Tile as their detailed status app.
|
|
|
- /// </summary>
|
|
|
- public string LockDetailedStatus3 { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// New in Anniversary Update: App-defined data that is passed back to your app via the TileActivatedInfo property on LaunchActivatedEventArgs when the user launches your app from the Live Tile. This allows you to know which Tile notifications your user saw when they tapped your Live Tile. On devices without the Anniversary Update, this will simply be ignored.
|
|
|
- /// </summary>
|
|
|
- public string Arguments { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// Provide an optional small binding to specify content for the small Tile size.
|
|
|
- /// </summary>
|
|
|
- public TileBinding TileSmall { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// Provide an optional medium binding to specify content for the medium Tile size.
|
|
|
- /// </summary>
|
|
|
- public TileBinding TileMedium { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// Provide an optional wide binding to specify content for the wide Tile size.
|
|
|
- /// </summary>
|
|
|
- public TileBinding TileWide { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// Desktop-only. Provide an optional large binding to specify content for the large Tile size.
|
|
|
- /// </summary>
|
|
|
- public TileBinding TileLarge { get; set; }
|
|
|
-
|
|
|
- /// <summary>
|
|
|
- /// Attempts to find and re-use an existing text element inside the binding. Returns true if it could. Otherwise returns false, and the caller will have to specify the detailed status using the lock hint attribute.
|
|
|
- /// </summary>
|
|
|
- /// <param name="lineNumber">The lock screen line number.</param>
|
|
|
- /// <param name="lockText">The lock screen line text.</param>
|
|
|
- /// <param name="binding">The binding to look in for matches.</param>
|
|
|
- /// <returns>True if could re-use existing text element, otherwise false.</returns>
|
|
|
- private static bool TryReuseTextElementForLockDetailedText(int lineNumber, string lockText, Element_TileBinding binding)
|
|
|
- {
|
|
|
- if (lockText == null)
|
|
|
- {
|
|
|
- throw new ArgumentNullException("lockText cannot be null");
|
|
|
- }
|
|
|
-
|
|
|
- if (binding == null)
|
|
|
- {
|
|
|
- throw new ArgumentNullException("binding cannot be null");
|
|
|
- }
|
|
|
-
|
|
|
- // If a text element already has an id with the line number (only look at immediate children, since the lockscreen will ignore things under groups/subgroups)
|
|
|
- Element_AdaptiveText matchingIdTextElement = binding.Children.OfType<Element_AdaptiveText>().FirstOrDefault(i => i.Id != null && i.Id.Equals(lineNumber.ToString()));
|
|
|
-
|
|
|
- if (matchingIdTextElement != null)
|
|
|
- {
|
|
|
- // If the text in the element matches the lock text, then we're good, don't need to assign anything else!
|
|
|
- if (matchingIdTextElement.Text != null && matchingIdTextElement.Text.Equals(lockText))
|
|
|
- {
|
|
|
- return true;
|
|
|
- }
|
|
|
-
|
|
|
- // Otherwise, we need to specify the lock text in the hint attribute, so we return false
|
|
|
- return false;
|
|
|
- }
|
|
|
-
|
|
|
- // Otherwise no text elements use that ID, so we could assign one if we find a text element that doesn't have an ID assigned and matches the lock text
|
|
|
- Element_AdaptiveText matchingTextTextElement = binding.Children.OfType<Element_AdaptiveText>().FirstOrDefault(i => i.Id == null && i.Text != null && i.Text.Equals(lockText));
|
|
|
-
|
|
|
- // If we found text that matched, we'll assign the id so it gets re-used for lock!
|
|
|
- if (matchingTextTextElement != null)
|
|
|
- {
|
|
|
- matchingTextTextElement.Id = lineNumber;
|
|
|
- return true;
|
|
|
- }
|
|
|
-
|
|
|
- // Otherwise we'll need to specify lock text in hint attribute, so return false
|
|
|
- return false;
|
|
|
- }
|
|
|
-
|
|
|
- internal Element_TileVisual ConvertToElement()
|
|
|
- {
|
|
|
- var visual = new Element_TileVisual()
|
|
|
- {
|
|
|
- Language = Language,
|
|
|
- BaseUri = BaseUri,
|
|
|
- Branding = Branding,
|
|
|
- AddImageQuery = AddImageQuery,
|
|
|
- ContentId = ContentId,
|
|
|
- DisplayName = DisplayName,
|
|
|
- Arguments = Arguments
|
|
|
- };
|
|
|
-
|
|
|
- if (TileSmall != null)
|
|
|
- {
|
|
|
- visual.Bindings.Add(TileSmall.ConvertToElement(TileSize.Small));
|
|
|
- }
|
|
|
-
|
|
|
- if (TileMedium != null)
|
|
|
- {
|
|
|
- visual.Bindings.Add(TileMedium.ConvertToElement(TileSize.Medium));
|
|
|
- }
|
|
|
-
|
|
|
- if (TileWide != null)
|
|
|
- {
|
|
|
- Element_TileBinding wideBindingElement = TileWide.ConvertToElement(TileSize.Wide);
|
|
|
-
|
|
|
- // If lock detailed status was specified, add them
|
|
|
- if (LockDetailedStatus1 != null)
|
|
|
- {
|
|
|
- // If we can't reuse existing text element, we'll have to use the hints
|
|
|
- if (!TryReuseTextElementForLockDetailedText(1, LockDetailedStatus1, wideBindingElement))
|
|
|
- {
|
|
|
- wideBindingElement.LockDetailedStatus1 = LockDetailedStatus1;
|
|
|
- }
|
|
|
- }
|
|
|
-
|
|
|
- if (LockDetailedStatus2 != null)
|
|
|
- {
|
|
|
- if (!TryReuseTextElementForLockDetailedText(2, LockDetailedStatus2, wideBindingElement))
|
|
|
- {
|
|
|
- wideBindingElement.LockDetailedStatus2 = LockDetailedStatus2;
|
|
|
- }
|
|
|
- }
|
|
|
-
|
|
|
- if (LockDetailedStatus3 != null)
|
|
|
- {
|
|
|
- if (!TryReuseTextElementForLockDetailedText(3, LockDetailedStatus3, wideBindingElement))
|
|
|
- {
|
|
|
- wideBindingElement.LockDetailedStatus3 = LockDetailedStatus3;
|
|
|
- }
|
|
|
- }
|
|
|
-
|
|
|
- visual.Bindings.Add(wideBindingElement);
|
|
|
- }
|
|
|
-
|
|
|
- // Otherwise if they specified lock values, throw an exception since lock values require wide
|
|
|
- else if (HasLockDetailedStatusValues())
|
|
|
- {
|
|
|
- throw new Exception("To provide lock detailed status text strings, you must also provide a TileWide binding. Either provide a TileWide binding, or leave the detailed status values null.");
|
|
|
- }
|
|
|
-
|
|
|
- if (TileLarge != null)
|
|
|
- {
|
|
|
- visual.Bindings.Add(TileLarge.ConvertToElement(TileSize.Large));
|
|
|
- }
|
|
|
-
|
|
|
- // TODO: If a BaseUri wasn't provided, we can potentially optimize the payload size by calculating the best BaseUri
|
|
|
- return visual;
|
|
|
- }
|
|
|
-
|
|
|
- private bool HasLockDetailedStatusValues()
|
|
|
- {
|
|
|
- return LockDetailedStatus1 != null && LockDetailedStatus2 != null && LockDetailedStatus3 != null;
|
|
|
- }
|
|
|
- }
|
|
|
-}
|