AccountsSettingsPane Classe

Definição

Namespace:

Windows.UI.ApplicationSettings

Fornece métodos para mostrar o painel de contas e também para permitir que o aplicativo registre retornos de chamada quando o submenu de contas estiver prestes a ser exibido.

public ref class AccountsSettingsPane sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
class AccountsSettingsPane final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
public sealed class AccountsSettingsPane

Public NotInheritable Class AccountsSettingsPane

Herança

Object Platform::Object IInspectable AccountsSettingsPane

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

O aplicativo fornece os retornos de chamada com metadados de conta para todos os provedores de conta Web, contas Web, comandos de conta global e credenciais de cofre de credenciais que o aplicativo exibe. Exemplos de provedores de conta são Facebook, LinkedIn e Twitter.

As classes de comando de conta e credencial no namespace Windows.UI.ApplicationSettings correspondem a objetos de dados no namespace Windows.UI.ApplicationSettings :

Objeto Data (Windows.Security.Credentials)	Objeto de interface do usuário (Windows.UI.ApplicationSettings)
WebAccount	WebAccountCommand
WebAccountProvider	WebAccountProviderCommand
PasswordCredential	CredentialCommand

Aplicativos da área de trabalho

Para um aplicativo da área de trabalho, em vez de usar a classe AccountSettingsPane, você precisará usar a API de interoperabilidade, conforme descrito abaixo.

• Primeiro Recupere um identificador de janela (HWND). Esse tópico contém exemplos de código para WinUI (Biblioteca de Interface do Usuário do Windows) 3, Windows Presentation Foundation (WPF) e Windows Forms (WinForms). Conecte esse código à listagem de código abaixo.
• Você deve usar a interface IAccountSettingsPaneInterop em seu aplicativo da área de trabalho. Para aplicativos C# que usam o .NET 6 ou posterior, a classe AccountSettingsPaneInterop está disponível. Para obter mais informações sobre as classes de interoperabilidade do C#, consulte Chamar APIs de interoperabilidade de um aplicativo .NET 5+. Consulte também Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

Veja a seguir um exemplo de como usar a classe AccountSettingsPaneInterop em C# (.NET 6 ou posterior):

private void LoginButton_Click(object sender, RoutedEventArgs e)
{
    // Retrieve the window handle for whichever UI framework being used (WinUI 3, WPF, WinForms)
    var hwnd = ...
    // Call methods from the interop class, passing in the window handle
    await AccountsSettingsPaneInterop.ShowManageAccountsForWindowAsync(hwnd);
}

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	ShowAddAccountAsync
1607	14393	ShowManageAccountsAsync
1803	17134	ShowAddAccountForUserAsync
1803	17134	ShowManageAccountsForUserAsync

Métodos

GetForCurrentView()	Obtém um objeto AccountsSettingsPane associado à exibição do aplicativo atual (ou seja, com CoreWindow).
Show()	Exibe o painel de configurações da conta.
ShowAddAccountAsync()	Exibe a tela Adicionar contas.
ShowAddAccountForUserAsync(User)	Exibe a tela adicionar contas para o usuário especificado.
ShowManageAccountsAsync()	Exibe a tela Gerenciar contas.
ShowManageAccountsForUserAsync(User)	Exibe a tela gerenciar contas para o usuário especificado.

Eventos

AccountCommandsRequested

Ocorre quando o usuário abre o painel de contas. Lidar com esse evento permite que o aplicativo inicialize os comandos de contas e pause sua interface do usuário até que o usuário feche o painel.

Confira também

• PasswordCredential
• WebAccountProvider
• WebAccount