SecondaryTile 构造函数

定义

命名空间:

Windows.UI.StartScreen

重载

SecondaryTile()	创建 SecondaryTile 对象。 然后，调用方必须通过 对象设置任何必需属性，然后才能尝试固定、更新或删除磁贴。 在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。
SecondaryTile(String)	创建具有特定 ID 的 SecondaryTile 对象。 此形式的构造函数应用于创建辅助磁贴对象以执行磁贴更新或删除。 在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。
SecondaryTile(String, String, String, Uri, TileSize)	创建 SecondaryTile 对象，该对象包含创建中等磁贴所需的所有必需属性。 在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。
SecondaryTile(String, String, String, String, TileOptions, Uri)	注意 此构造函数可能在Windows 8.1后更改或不适用于发布。 请改用 SecondaryTile.SecondaryTile (String、String、String、Uri、TileSize) 。 创建 SecondaryTile 对象作为中等磁贴。 在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	注意 此构造函数可能在Windows 8.1后更改或不适用于发布。 请改用 SecondaryTile.SecondaryTile (String、String、String、Uri、TileSize) 并通过 SecondaryTile.VisualElements 方法提供其他磁贴大小和选项。 创建一个 SecondaryTile 对象作为加宽磁贴。 在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。 在 Windows Phone 8.1 上，所有磁贴（包括辅助磁贴）都固定为中等磁贴，之后用户可以调整其大小。 此构造函数提供调整为加宽磁贴大小的选项。

SecondaryTile()

创建 SecondaryTile 对象。 然后，调用方必须通过 对象设置任何必需属性，然后才能尝试固定、更新或删除磁贴。

在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

注解

必须先通过调用此类的其他方法设置必需的磁贴属性（如显示名称），然后才能激活磁贴。

SecondaryTile(String)

创建具有特定 ID 的 SecondaryTile 对象。 此形式的构造函数应用于创建辅助磁贴对象以执行磁贴更新或删除。

在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

public:
 SecondaryTile(Platform::String ^ tileId);

 SecondaryTile(winrt::hstring const& tileId);

public SecondaryTile(string tileId);

function SecondaryTile(tileId)

Public Sub New (tileId As String)

参数

tileId

String

Platform::String

winrt::hstring

一个字符串，用于唯一标识应用中的磁贴。 选择对应用具有描述性且有意义的唯一 ID。 如果提供的 ID 与现有辅助磁贴的 ID 相同，则会覆盖现有的辅助磁贴。

注解

用于创建此磁贴的唯一 ID 可在以后更新或删除它。

其他必需的磁贴属性（如显示名称）必须通过调用此类的其他方法进行设置，然后才能激活磁贴。

SecondaryTile(String, String, String, Uri, TileSize)

创建 SecondaryTile 对象，该对象包含创建中等磁贴所需的所有必需属性。

在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ displayName, Platform::String ^ arguments, Uri ^ square150x150Logo, TileSize desiredSize);

 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& displayName, winrt::hstring const& arguments, Uri const& square150x150Logo, TileSize const& desiredSize);

public SecondaryTile(string tileId, string displayName, string arguments, System.Uri square150x150Logo, TileSize desiredSize);

function SecondaryTile(tileId, displayName, arguments, square150x150Logo, desiredSize)

Public Sub New (tileId As String, displayName As String, arguments As String, square150x150Logo As Uri, desiredSize As TileSize)

参数

tileId

String

Platform::String

winrt::hstring

一个字符串，用于唯一标识应用包中的磁贴。 选择对应用具有描述性且有意义的唯一 ID。 它限制为 64 个字符，必须以数字或字母开头，并且由字符 a-z、A-Z、0-9、句点 (.) 或下划线 (_) 组成。 如果提供的 ID 与现有辅助磁贴的 ID 相同，则会覆盖现有的辅助磁贴。 可以通过 TileId 属性设置或检索。

displayName

String

Platform::String

winrt::hstring

在磁贴、磁贴的工具提示中以及在显示小磁贴（例如 应用 或搜索结果屏幕上）时显示的名称。 此字符串等效于清单中为main磁贴提供的显示名称。 它限制为 256 个字符，但在实践中应保持简短以避免截断。 可以通过 DisplayName 属性设置或检索此值。

显示名称仅显示在 Windows Phone 8.1 上的加宽辅助磁贴上。

arguments

String

Platform::String

winrt::hstring

对调用应用程序有意义的应用定义的字符串。 从辅助磁贴激活应用时，此参数字符串将传递回应用。 在 2048 个字符后将被截断。 可以通过 Arguments 属性设置或检索。

注意

此参数必须为 Windows Phone Silverlight 8.1 应用进行 URL 编码。 所有其他应用类型都可以使用其自己的结构。

square150x150Logo

Uri Uri

对存储在统一资源标识符 (URI) 的中等徽标图像的引用。 可以通过 SecondaryTileVisualElements.Square150x150Logo 属性设置或检索。 可以使用以下方案之一来表示此值：ms-appx:/// 已部署的应用包中的路径。 此路径针对应用支持的语言和 DPI 高原解析。ms-appdata:///local/ 在每用户应用存储中找到的文件。

desiredSize

TileSize

要固定的磁贴的大小。 此值必须为 默认 (，它提供 Windows 8 行为) 、 Square150x150 或 Wide310x150。 任何其他 TileSize 值都会导致在运行时引发异常。

在 Windows Phone 8.1 上忽略 desiredSize 参数。 在手机上，所有磁贴（包括辅助磁贴）都固定为中等磁贴，之后用户可以调整其大小。

SecondaryTile(String, String, String, String, TileOptions, Uri)

注意

此构造函数可能在Windows 8.1后更改或不适用于发布。 请改用 SecondaryTile.SecondaryTile (String、String、String、Uri、TileSize) 。

创建 SecondaryTile 对象作为中等磁贴。

在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference);

function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference)

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri)

参数

tileId

String

Platform::String

winrt::hstring

一个字符串，用于唯一标识应用包中的磁贴。 选择对应用具有描述性且有意义的唯一 ID。 它限制为 64 个字符，必须以数字或字母开头，并且由字符 a-z、A-Z、0-9、句点 (.) 或下划线 (_) 组成。 如果提供的 ID 与现有辅助磁贴的 ID 相同，则会覆盖现有的辅助磁贴。 可以通过 TileId 属性设置或检索。

shortName

String

Platform::String

winrt::hstring

如果应用选择这样做，则直接显示在磁贴上的短名称。 超过 40 个字符的任何内容将被截断。 用户可以选择在固定过程中更改此值。 可以通过 ShortName 属性设置或检索。

注意

此值仅在 Windows 8 中使用，在更高版本中弃用 displayName 。

displayName

String

Platform::String

winrt::hstring

在磁贴、磁贴的工具提示中以及在显示小磁贴（例如 应用 或搜索结果屏幕上）时显示的名称。 此字符串等效于清单中为main磁贴提供的显示名称。 它限制为 256 个字符，但在实践中应保持简短以避免截断。 可以通过 DisplayName 属性设置或检索此值。

显示名称仅显示在 Windows Phone 8.1 上的加宽辅助磁贴上。

arguments

String

Platform::String

winrt::hstring

对调用应用程序有意义的应用定义的字符串。 从辅助磁贴激活应用时，此参数字符串将传递回应用。 在 2048 个字符后将被截断。 可以通过 Arguments 属性设置或检索。

tileOptions

TileOptions

一个 值，该值指定各种选项，例如名称是否将显示在辅助磁贴上。 可以通过 TileOptions 属性设置或检索。

logoReference

Uri Uri

对存储在统一资源标识符 (URI) 的方形徽标图像的引用。 可以通过 Logo 属性设置或检索。 可以使用以下方案之一来表示此值：ms-appx:/// 已部署的应用包中的路径。 此路径针对应用支持的语言和 DPI 高原解析。ms-appdata:///local/ 在每用户应用存储中找到的文件。

属性

DeprecatedAttribute

SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)

注意

此构造函数可能在Windows 8.1后更改或不适用于发布。 请改用 SecondaryTile.SecondaryTile (String、String、String、Uri、TileSize) 并通过 SecondaryTile.VisualElements 方法提供其他磁贴大小和选项。

创建一个 SecondaryTile 对象作为加宽磁贴。

在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

在 Windows Phone 8.1 上，所有磁贴（包括辅助磁贴）都固定为中等磁贴，之后用户可以调整其大小。 此构造函数提供调整为加宽磁贴大小的选项。

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference, Uri ^ wideLogoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference, Uri const& wideLogoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference, System.Uri wideLogoReference);

function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference, wideLogoReference)

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri, wideLogoReference As Uri)

参数

tileId

String

Platform::String

winrt::hstring

一个字符串，用于唯一标识应用包中的磁贴。 选择对应用具有描述性且有意义的唯一 ID。 它限制为 64 个字符，必须以数字或字母开头，并且由字符 a-z、A-Z、0-9、句点 (.) 或下划线 (_) 组成。 如果提供的 ID 与现有辅助磁贴的 ID 相同，则会覆盖现有的辅助磁贴。 可以通过 TileId 属性设置或检索。

shortName

String

Platform::String

winrt::hstring

如果应用选择这样做，则直接显示在磁贴上的短名称。 超过 40 个字符的任何内容将被截断。 用户可以选择在固定过程中更改此值。 可以通过 ShortName 属性设置或检索。

注意

此值仅在 Windows 8 中使用，在更高版本中弃用 displayName 。

displayName

String

Platform::String

winrt::hstring

在磁贴、磁贴的工具提示中以及在显示小磁贴（例如 应用 或搜索结果屏幕上）时显示的名称。 此字符串等效于清单中为main磁贴提供的显示名称。 它限制为 256 个字符，但在实践中应保持简短以避免截断。 可以通过 DisplayName 属性设置或检索此值。

显示名称仅显示在 Windows Phone 8.1 上的加宽辅助磁贴上。

arguments

String

Platform::String

winrt::hstring

对调用应用程序有意义的应用定义的字符串。 从辅助磁贴激活应用时，此参数字符串将传递回应用。 在 2048 个字符后将被截断。 可以通过 Arguments 属性设置或检索。

tileOptions

TileOptions

一个 值，该值指定各种选项，例如名称是否将显示在辅助磁贴上。 可以通过 TileOptions 属性设置或检索。

logoReference

Uri Uri

对存储在统一资源标识符 (URI) 的中等徽标图像的引用。 可以通过 Square150x150Logo 属性设置或检索。 可以使用以下方案之一来表示此值：ms-appx:/// 已部署的应用包中的路径。 此路径针对应用支持的语言和 DPI 高原解析。ms-appdata:///local/ 在每用户应用存储中找到的文件。

wideLogoReference

Uri Uri

对存储在统一资源标识符 (URI) 的宽徽标图像的引用。 可以通过 WideLogo 属性设置或检索。 可以使用以下方案之一来表示此值：ms-appx:/// 已部署的应用包中的路径。 此路径针对应用支持的语言和 DPI 高原解析。ms-appdata:///local/ 在每用户应用存储中找到的文件。

属性

DeprecatedAttribute