AccountsSettingsPane Clase

Definición

Espacio de nombres:

Windows.UI.ApplicationSettings

Proporciona métodos para mostrar el panel de cuentas y también para permitir que la aplicación registre devoluciones de llamada cuando el control flotante de cuentas está a punto de mostrarse.

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

Herencia

Object Platform::Object IInspectable AccountsSettingsPane

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La aplicación proporciona las devoluciones de llamada con metadatos de cuenta para todos los proveedores de cuentas web, cuentas web, comandos de cuenta global y credenciales de caja de seguridad de credenciales que muestra la aplicación. Algunos ejemplos de proveedores de cuentas son Facebook, LinkedIn y Twitter.

Las clases de comandos account y credential del espacio de nombres Windows.UI.ApplicationSettings corresponden a objetos de datos en el espacio de nombres Windows.UI.ApplicationSettings :

Objeto Data (Windows.Security.Credentials)	Objeto UI (Windows.UI.ApplicationSettings)
WebAccount	WebAccountCommand
WebAccountProvider	WebAccountProviderCommand
PasswordCredential	CredentialCommand

Aplicaciones de escritorio

Para una aplicación de escritorio, en lugar de usar la clase AccountSettingsPane, deberá usar la API de interoperabilidad como se describe a continuación.

• En primer lugar, recupere un identificador de ventana (HWND). Este tema contiene ejemplos de código para la Biblioteca de interfaz de usuario de Windows (WinUI) 3, Windows Presentation Foundation (WPF) y Windows Forms (WinForms). Conecte ese código a la lista de código siguiente.
• Debe usar la interfaz IAccountSettingsPaneInterop en la aplicación de escritorio. En el caso de las aplicaciones de C# que usan .NET 6 o posterior, la clase AccountSettingsPaneInterop está disponible. Para obtener más información sobre las clases de interoperabilidad de C#, consulte Llamada a las API de interoperabilidad desde una aplicación de .NET 5+. Consulta también Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

A continuación se muestra un ejemplo sobre cómo usar la clase AccountSettingsPaneInterop en C# (.NET 6 o 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);
}

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	ShowAddAccountAsync
1607	14393	ShowManageAccountsAsync
1803	17134	ShowAddAccountForUserAsync
1803	17134	ShowManageAccountsForUserAsync

Métodos

GetForCurrentView()	Obtiene un objeto AccountsSettingsPane asociado a la vista de aplicación actual (es decir, con CoreWindow).
Show()	Muestra el panel de configuración de la cuenta.
ShowAddAccountAsync()	Muestra la pantalla Agregar cuentas.
ShowAddAccountForUserAsync(User)	Muestra la pantalla Agregar cuentas para el usuario especificado.
ShowManageAccountsAsync()	Muestra la pantalla administrar cuentas.
ShowManageAccountsForUserAsync(User)	Muestra la pantalla administrar cuentas para el usuario especificado.

Eventos

AccountCommandsRequested

Se produce cuando el usuario abre el panel de cuentas. Controlar este evento permite a la aplicación inicializar los comandos de cuentas y pausar su interfaz de usuario hasta que el usuario cierre el panel.

Consulte también

• PasswordCredential
• WebAccountProvider
• WebAccount