AccountsSettingsPane Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 AccountsSettingsPanePublic NotInheritable Class AccountsSettingsPane- Herança
- Atributos
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. |