Compartilhar via


SecondaryTile Construtores

Definição

Sobrecargas

SecondaryTile()

Cria um objeto SecondaryTile . Em seguida, o chamador deve definir todas as propriedades obrigatórias por meio do objeto antes de tentar fixar, atualizar ou excluir o bloco.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

SecondaryTile(String)

Cria um objeto SecondaryTile com uma ID específica. Essa forma do construtor deve ser usada para criar um objeto de bloco secundário para executar uma atualização ou exclusão de bloco.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

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

Cria um objeto SecondaryTile que inclui todas as propriedades obrigatórias necessárias para criar um bloco médio.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

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

Observação

Esse construtor pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Cria um objeto SecondaryTile como um bloco médio.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

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

Observação

Esse construtor pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) e forneça outros tamanhos e opções de bloco por meio do método SecondaryTile.VisualElements .

Cria um objeto SecondaryTile como um bloco largo.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

No Windows Phone 8.1, todos os blocos, incluindo blocos secundários, são fixados como blocos médios, após os quais podem ser redimensionados pelo usuário. Esse construtor fornece essa opção de redimensionamento para um bloco largo.

SecondaryTile()

Cria um objeto SecondaryTile . Em seguida, o chamador deve definir todas as propriedades obrigatórias por meio do objeto antes de tentar fixar, atualizar ou excluir o bloco.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

public:
 SecondaryTile();
 SecondaryTile();
public SecondaryTile();
function SecondaryTile()
Public Sub New ()

Comentários

Propriedades de bloco obrigatórias, como o nome de exibição, devem ser definidas por meio de chamadas para outros métodos dessa classe antes que o bloco possa ser ativado.

Aplica-se a

SecondaryTile(String)

Cria um objeto SecondaryTile com uma ID específica. Essa forma do construtor deve ser usada para criar um objeto de bloco secundário para executar uma atualização ou exclusão de bloco.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

public:
 SecondaryTile(Platform::String ^ tileId);
 SecondaryTile(winrt::hstring const& tileId);
public SecondaryTile(string tileId);
function SecondaryTile(tileId)
Public Sub New (tileId As String)

Parâmetros

tileId
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que identificará exclusivamente o bloco em seu aplicativo. Escolha uma ID exclusiva descritiva e significativa para seu aplicativo. Se você fornecer a mesma ID que a de um bloco secundário existente, o bloco secundário existente será substituído.

Comentários

A ID exclusiva que você usa para criar esse bloco pode ser usada posteriormente para atualizá-lo ou excluí-lo.

Outras propriedades de bloco obrigatórias, como o nome de exibição, devem ser definidas por meio de chamadas para outros métodos dessa classe antes que o bloco possa ser ativado.

Aplica-se a

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

Cria um objeto SecondaryTile que inclui todas as propriedades obrigatórias necessárias para criar um bloco médio.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do 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)

Parâmetros

tileId
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que identificará exclusivamente o bloco dentro do pacote do aplicativo. Escolha uma ID exclusiva descritiva e significativa para seu aplicativo. Ele é limitado a 64 caracteres e deve começar com um número ou letra e ser composto pelos caracteres a-z, A-Z, 0-9, ponto final (.) ou sublinhado (_). Se você fornecer a mesma ID que a de um bloco secundário existente, o bloco secundário existente será substituído. Pode ser definido ou recuperado por meio da propriedade TileId .

displayName
String

Platform::String

winrt::hstring

Um nome a ser exibido no bloco, na dica de ferramenta do bloco e ao mostrar blocos pequenos, como nas telas Aplicativos ou resultados da pesquisa. Essa cadeia de caracteres é equivalente ao nome de exibição fornecido no manifesto do bloco main. Ele é restrito a 256 caracteres, mas na prática deve ser mantido curto para evitar truncamento. Esse valor pode ser definido ou recuperado por meio da propriedade DisplayName .

O nome de exibição é mostrado apenas no bloco secundário largo no Windows Phone 8.1.

arguments
String

Platform::String

winrt::hstring

Uma cadeia de caracteres definida pelo aplicativo significativa para o aplicativo de chamada. Essa cadeia de caracteres de argumento é passada de volta para o aplicativo quando o aplicativo é ativado do bloco secundário. Ele será truncado após 2.048 caracteres. Pode ser definido ou recuperado por meio da propriedade Arguments .

Observação

Esse parâmetro deve ser codificado em URL para Windows Phone aplicativos silverlight 8.1. Todos os outros tipos de aplicativo podem usar sua própria estrutura.

square150x150Logo
Uri Uri

Uma referência a uma imagem de logotipo médio armazenada em um URI (Uniform Resource Identifier). Pode ser definido ou recuperado por meio da propriedade SecondaryTileVisualElements.Square150x150Logo . Esse valor pode ser expresso usando um destes esquemas: caminho ms-appx:/// A dentro do pacote do aplicativo implantado. Esse caminho é resolvido para idiomas e o planalto de DPI com suporte do aplicativo.arquivo ms-appdata:///local/ A encontrado no armazenamento de aplicativos por usuário.

desiredSize
TileSize

O tamanho do bloco a ser fixado. Esse valor deve ser Default (que fornece o comportamento do Windows 8), Square150x150 ou Wide310x150. Qualquer outro valor TileSize faz com que uma exceção seja gerada durante o runtime.

O parâmetro desiredSize é ignorado no Windows Phone 8.1. No telefone, todos os blocos, incluindo blocos secundários, são fixados como blocos médios, após os quais podem ser redimensionados pelo usuário.

Aplica-se a

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

Observação

Esse construtor pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Cria um objeto SecondaryTile como um bloco médio.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do 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")]
 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, typeof(Windows.Foundation.UniversalApiContract))]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.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")]
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)

Parâmetros

tileId
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que identificará exclusivamente o bloco dentro do pacote do aplicativo. Escolha uma ID exclusiva descritiva e significativa para seu aplicativo. Ele é limitado a 64 caracteres e deve começar com um número ou letra e ser composto pelos caracteres a-z, A-Z, 0-9, ponto final (.) ou sublinhado (_). Se você fornecer a mesma ID que a de um bloco secundário existente, o bloco secundário existente será substituído. Pode ser definido ou recuperado por meio da propriedade TileId .

shortName
String

Platform::String

winrt::hstring

Um nome curto a ser exibido diretamente no bloco se o aplicativo optar por fazer isso. Qualquer coisa com mais de 40 caracteres será truncada. O usuário tem a opção de alterar esse valor como parte do processo de fixação. Pode ser definido ou recuperado por meio da propriedade ShortName .

Observação

Esse valor é usado apenas no Windows 8 e foi preterido em favor do displayName em versões posteriores.

displayName
String

Platform::String

winrt::hstring

Um nome a ser exibido no bloco, na dica de ferramenta do bloco e ao mostrar blocos pequenos, como nas telas Aplicativos ou resultados da pesquisa. Essa cadeia de caracteres é equivalente ao nome de exibição fornecido no manifesto do bloco main. Ele é restrito a 256 caracteres, mas na prática deve ser mantido curto para evitar truncamento. Esse valor pode ser definido ou recuperado por meio da propriedade DisplayName .

O nome de exibição é mostrado apenas no bloco secundário largo no Windows Phone 8.1.

arguments
String

Platform::String

winrt::hstring

Uma cadeia de caracteres definida pelo aplicativo significativa para o aplicativo de chamada. Essa cadeia de caracteres de argumento é passada de volta para o aplicativo quando o aplicativo é ativado do bloco secundário. Ele será truncado após 2048 caracteres. Pode ser definido ou recuperado por meio da propriedade Arguments .

tileOptions
TileOptions

Um valor que especifica várias opções, como se o nome será exibido no bloco secundário. Pode ser definido ou recuperado por meio da propriedade TileOptions .

logoReference
Uri Uri

Uma referência a uma imagem de logotipo quadrado armazenada em um URI (Uniform Resource Identifier). Pode ser definido ou recuperado por meio da propriedade Logo . Esse valor pode ser expresso usando um destes esquemas: caminho ms-appx:/// A dentro do pacote de aplicativos implantado. Esse caminho é resolvido para idiomas e planalto de DPI com suporte do aplicativo.arquivo ms-appdata:///local/ A encontrado no armazenamento de aplicativos por usuário.

Atributos

Aplica-se a

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

Observação

Esse construtor pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) e forneça outros tamanhos e opções de bloco por meio do método SecondaryTile.VisualElements .

Cria um objeto SecondaryTile como um bloco largo.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

No Windows Phone 8.1, todos os blocos, incluindo blocos secundários, são fixados como blocos médios, após os quais podem ser redimensionados pelo usuário. Esse construtor fornece essa opção de redimensionamento para um bloco largo.

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")]
 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, typeof(Windows.Foundation.UniversalApiContract))]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference, System.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")]
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)

Parâmetros

tileId
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que identificará exclusivamente o bloco dentro do pacote do aplicativo. Escolha uma ID exclusiva descritiva e significativa para seu aplicativo. Ele é limitado a 64 caracteres e deve começar com um número ou letra e ser composto pelos caracteres a-z, A-Z, 0-9, ponto (.) ou sublinhado (_). Se você fornecer a mesma ID que a de um bloco secundário existente, o bloco secundário existente será substituído. Pode ser definido ou recuperado por meio da propriedade TileId .

shortName
String

Platform::String

winrt::hstring

Um nome curto a ser exibido diretamente no bloco se o aplicativo optar por fazer isso. Qualquer coisa com mais de 40 caracteres será truncada. O usuário tem a opção de alterar esse valor como parte do processo de fixação. Pode ser definido ou recuperado por meio da propriedade ShortName .

Observação

Esse valor é usado apenas no Windows 8 e foi preterido em favor do displayName em versões posteriores.

displayName
String

Platform::String

winrt::hstring

Um nome a ser exibido no bloco, na dica de ferramenta do bloco e ao mostrar blocos pequenos, como nas telas Aplicativos ou resultados da pesquisa. Essa cadeia de caracteres é equivalente ao nome de exibição fornecido no manifesto do bloco main. Ele é restrito a 256 caracteres, mas na prática deve ser mantido curto para evitar truncamento. Esse valor pode ser definido ou recuperado por meio da propriedade DisplayName .

O nome de exibição é mostrado apenas no bloco secundário largo no Windows Phone 8.1.

arguments
String

Platform::String

winrt::hstring

Uma cadeia de caracteres definida pelo aplicativo significativa para o aplicativo de chamada. Essa cadeia de caracteres de argumento é passada de volta para o aplicativo quando o aplicativo é ativado do bloco secundário. Ele será truncado após 2048 caracteres. Pode ser definido ou recuperado por meio da propriedade Arguments .

tileOptions
TileOptions

Um valor que especifica várias opções, como se o nome será exibido no bloco secundário. Pode ser definido ou recuperado por meio da propriedade TileOptions .

logoReference
Uri Uri

Uma referência a uma imagem de logotipo médio armazenada em um URI (Uniform Resource Identifier). Pode ser definido ou recuperado por meio da propriedade Square150x150Logo . Esse valor pode ser expresso usando um destes esquemas: caminho ms-appx:/// A dentro do pacote de aplicativos implantado. Esse caminho é resolvido para idiomas e planalto de DPI com suporte do aplicativo.arquivo ms-appdata:///local/ A encontrado no armazenamento de aplicativos por usuário.

wideLogoReference
Uri Uri

Uma referência a uma imagem de logotipo ampla armazenada em um URI (Uniform Resource Identifier). Pode ser definido ou recuperado por meio da propriedade WideLogo . Esse valor pode ser expresso usando um destes esquemas: caminho ms-appx:/// A dentro do pacote de aplicativos implantado. Esse caminho é resolvido para idiomas e planalto de DPI com suporte do aplicativo.arquivo ms-appdata:///local/ A encontrado no armazenamento de aplicativos por usuário.

Atributos

Aplica-se a