AccountsSettingsPane Classe

Référence

Définition

Espace de noms:: Windows.UI.ApplicationSettings

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Fournit des méthodes pour afficher le volet comptes et permettre à l’application d’inscrire des rappels lorsque le menu volant des comptes est sur le point d’être affiché.

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

Héritage: Object Platform::Object IInspectable AccountsSettingsPane

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

L’application fournit aux rappels des métadonnées de compte pour tous les fournisseurs de comptes web, les comptes web, les commandes de compte global et les informations d’identification de casier d’informations d’identification affichées par l’application. Facebook, LinkedIn et Twitter sont des exemples de fournisseurs de comptes.

Les classes de commande account et credential dans l’espace de noms Windows.UI.ApplicationSettings correspondent aux objets de données de l’espace de noms Windows.UI.ApplicationSettings :

Data, objet (Windows.Security.Credentials)	Objet UI (Windows.UI.ApplicationSettings)
WebAccount	WebAccountCommand
WebAccountProvider	WebAccountProviderCommand
PasswordCredential	CredentialCommand

Applications de bureau

Pour une application de bureau, au lieu d’utiliser la classe AccountSettingsPane, vous devez utiliser l’API d’interopérabilité comme décrit ci-dessous.

Commencez par récupérer un handle de fenêtre (HWND). Cette rubrique contient des exemples de code pour la bibliothèque d’interface utilisateur Windows (WinUI) 3, Windows Presentation Foundation (WPF) et Windows Forms (WinForms). Branchez ce code dans la liste de codes ci-dessous.
Vous devez utiliser l’interface IAccountSettingsPaneInterop dans votre application de bureau. Pour les applications C# utilisant .NET 6 ou version ultérieure, la classe AccountSettingsPaneInterop est disponible. Pour plus d’informations sur les classes d’interopérabilité C#, consultez Appeler des API d’interopérabilité à partir d’une application .NET 5+. Consultez également Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

Voici un exemple d’utilisation de la classe AccountSettingsPaneInterop en C# (.NET 6 ou version ultérieure) :

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);
}

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	ShowAddAccountAsync
1607	14393	ShowManageAccountsAsync
1803	17134	ShowAddAccountForUserAsync
1803	17134	ShowManageAccountsForUserAsync

Méthodes

GetForCurrentView()	Obtient un objet AccountsSettingsPane associé à la vue d’application actuelle (c’est-à-dire à CoreWindow).
Show()	Affiche le volet des paramètres du compte.
ShowAddAccountAsync()	Affiche l’écran Ajouter des comptes.
ShowAddAccountForUserAsync(User)	Affiche l’écran Ajouter des comptes pour l’utilisateur spécifié.
ShowManageAccountsAsync()	Affiche l’écran Gérer les comptes.
ShowManageAccountsForUserAsync(User)	Affiche l’écran gérer les comptes pour l’utilisateur spécifié.

Événements

AccountCommandsRequested

Se produit lorsque l’utilisateur ouvre le volet comptes. La gestion de cet événement permet à l’application d’initialiser les commandes des comptes et de suspendre son interface utilisateur jusqu’à ce que l’utilisateur ferme le volet.

S’applique à