SecondaryTile Конструкторы

Определение

Пространство имен:

Windows.UI.StartScreen

Перегрузки

SecondaryTile()	Создает объект SecondaryTile . Затем вызывающий объект должен задать все обязательные свойства с помощью объекта , прежде чем пытаться закрепить, обновить или удалить плитку. В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.
SecondaryTile(String)	Создает объект SecondaryTile с определенным идентификатором. Эта форма конструктора должна использоваться для создания вторичного объекта плитки для выполнения обновления или удаления плитки. В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.
SecondaryTile(String, String, String, Uri, TileSize)	Создает объект SecondaryTile , включающий все обязательные свойства, необходимые для создания средней плитки. В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri)	Примечание Этот конструктор может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize). Создает объект SecondaryTile в виде средней плитки. В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	Примечание Этот конструктор может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) и предоставьте другие размеры и параметры плитки с помощью метода SecondaryTile.VisualElements . Создает объект SecondaryTile в виде широкой плитки. В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow. В Windows Phone 8.1 все плитки, включая вторичные, закрепляются как средние плитки, после чего пользователь может изменить их размер. Этот конструктор предоставляет возможность изменения размера до широкой плитки.

SecondaryTile()

Создает объект SecondaryTile . Затем вызывающий объект должен задать все обязательные свойства с помощью объекта , прежде чем пытаться закрепить, обновить или удалить плитку.

В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

Комментарии

Перед активацией плитки необходимо задать обязательные свойства плитки, такие как отображаемое имя, с помощью вызовов других методов этого класса.

SecondaryTile(String)

Создает объект SecondaryTile с определенным идентификатором. Эта форма конструктора должна использоваться для создания вторичного объекта плитки для выполнения обновления или удаления плитки.

В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

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

Строка, которая однозначно идентифицирует плитку в приложении. Выберите уникальный идентификатор, который будет описательным и значимым для вашего приложения. Если указать тот же идентификатор, что и у существующей вторичной плитки, существующая вторичная плитка будет перезаписана.

Комментарии

Уникальный идентификатор, используемый для создания этой плитки, можно использовать позже для ее обновления или удаления.

Другие обязательные свойства плитки, такие как отображаемое имя, необходимо задать с помощью вызовов других методов этого класса, прежде чем плитку можно будет активировать.

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

Создает объект SecondaryTile , включающий все обязательные свойства, необходимые для создания средней плитки.

В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

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

Строка, которая однозначно идентифицирует плитку в пакете приложения. Выберите уникальный идентификатор, который будет описательным и значимым для вашего приложения. Он ограничен 64 символами и должен начинаться с цифры или буквы и состоять из символов a–z, A–Z, 0–9, точки (.) или подчеркивания (_). Если указать тот же идентификатор, что и у существующей вторичной плитки, существующая вторичная плитка будет перезаписана. Можно задать или получить с помощью свойства TileId .

displayName

String

Platform::String

winrt::hstring

Имя, отображаемое на плитке, в подсказке плитки и при отображении небольших плиток, например на экранах Приложения или результаты поиска. Эта строка эквивалентна отображаемого имени, заданному в манифесте для плитки main. Он ограничен 256 символами, но на практике должен быть коротким, чтобы избежать усечения. Это значение можно задать или получить с помощью свойства DisplayName .

Отображаемое имя отображается только на широкой вспомогательной плитке в Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Определяемая приложением строка, значимая для вызывающего приложения. Эта строка аргумента передается обратно в приложение при активации приложения из вторичной плитки. Он будет усечен после 2048 символов. Можно задать или получить с помощью свойства Arguments .

Примечание

Этот параметр должен быть закодирован в URL-адресе для приложений Windows Phone Silverlight 8.1. Все остальные типы приложений могут использовать собственную структуру.

square150x150Logo

Uri Uri

Ссылка на изображение среднего логотипа, хранящееся в универсальном коде ресурса (URI). Можно задать или получить с помощью свойства SecondaryTileVisualElements.Square150x150Logo . Это значение можно выразить с помощью одной из следующих схем: путь ms-appx:/// A в развернутом пакете приложения. Этот путь разрешается для языков и плато DPI, поддерживаемых приложением.файл ms-appdata:///local/ A, который находится в хранилище приложений для каждого пользователя.

desiredSize

TileSize

Размер закрепляемой плитки. Это значение должно быть по умолчанию (которое обеспечивает поведение Windows 8), Square150x150 или Wide310x150. Любое другое значение TileSize вызывает исключение во время выполнения.

Параметр desiredSize игнорируется в Windows Phone 8.1. На телефоне все плитки, включая вспомогательные, закрепляются как средние плитки, после чего пользователь может изменить их размер.

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

Примечание

Этот конструктор может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Создает объект SecondaryTile в виде средней плитки.

В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

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

Строка, которая однозначно идентифицирует плитку в пакете приложения. Выберите уникальный идентификатор, который будет описательным и значимым для вашего приложения. Он ограничен 64 символами и должен начинаться с цифры или буквы и состоять из символов a–z, A–Z, 0–9, точки (.) или подчеркивания (_). Если указать тот же идентификатор, что и у существующей вторичной плитки, существующая вторичная плитка будет перезаписана. Можно задать или получить с помощью свойства 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:/// A в развернутом пакете приложения. Этот путь разрешается для языков и плато DPI, поддерживаемых приложением.файл ms-appdata:///local/ A, который находится в хранилище приложений для каждого пользователя.

Атрибуты

DeprecatedAttribute

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

Примечание

Этот конструктор может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) и предоставьте другие размеры и параметры плитки с помощью метода SecondaryTile.VisualElements .

Создает объект SecondaryTile в виде широкой плитки.

В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

В 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

Строка, которая однозначно идентифицирует плитку в пакете приложения. Выберите уникальный идентификатор, который будет описательным и значимым для вашего приложения. Он ограничен 64 символами и должен начинаться с цифры или буквы и состоять из символов a–z, A–Z, 0–9, точки (.) или подчеркивания (_). Если указать тот же идентификатор, что и у существующей вторичной плитки, существующая вторичная плитка будет перезаписана. Можно задать или получить с помощью свойства 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:/// A в развернутом пакете приложения. Этот путь разрешается для языков и плато DPI, поддерживаемых приложением.файл ms-appdata:///local/ A, который находится в хранилище приложений для каждого пользователя.

wideLogoReference

Uri Uri

Ссылка на широкое изображение логотипа, хранящееся в универсальном коде ресурса (URI). Можно задать или получить с помощью свойства WideLogo . Это значение можно выразить с помощью одной из следующих схем: путь ms-appx:/// A в развернутом пакете приложения. Этот путь разрешается для языков и плато DPI, поддерживаемых приложением.файл ms-appdata:///local/ A, который находится в хранилище приложений для каждого пользователя.

Атрибуты

DeprecatedAttribute