AccountsSettingsPane Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.ApplicationSettings

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Menyediakan metode untuk menampilkan panel akun dan juga untuk memungkinkan aplikasi mendaftarkan panggilan balik saat flyout akun akan ditampilkan.

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

Warisan: Object Platform::Object IInspectable AccountsSettingsPane

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Aplikasi ini menyediakan panggilan balik dengan metadata akun untuk semua penyedia akun web, akun web, perintah akun global, dan kredensial loker kredensial yang ditampilkan aplikasi. Contoh penyedia akun adalah Facebook, LinkedIn, dan Twitter.

Kelas perintah akun dan kredensial di namespace Windows.UI.ApplicationSettings sesuai dengan objek data di namespace Layanan Windows.UI.ApplicationSettings :

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

Aplikasi desktop

Untuk aplikasi desktop, alih-alih menggunakan kelas AccountSettingsPane, Anda harus menggunakan API interop seperti yang dijelaskan di bawah ini.

Pertama Ambil handel jendela (HWND). Topik tersebut berisi contoh kode untuk Windows UI Library (WinUI) 3, Windows Presentation Foundation (WPF), dan Formulir Windows (WinForms). Colokkan kode tersebut ke dalam daftar kode di bawah ini.
Anda harus menggunakan antarmuka IAccountSettingsPaneInterop di aplikasi desktop Anda. Untuk aplikasi C# yang menggunakan .NET 6 atau yang lebih baru, kelas AccountSettingsPaneInterop tersedia. Untuk informasi selengkapnya tentang kelas interop C#, lihat Memanggil API interop dari aplikasi .NET 5+. Lihat juga Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

Berikut ini adalah contoh tentang cara menggunakan kelas AccountSettingsPaneInterop di C# (.NET 6 atau yang lebih baru):

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

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	TampilkanAddAccountAsync
1607	14393	ShowManageAccountsAsync
1803	17134	TampilkanAddAccountForUserAsync
1803	17134	ShowManageAccountsForUserAsync

Metode

GetForCurrentView()	Mendapatkan objek AccountsSettingsPane yang terkait dengan tampilan aplikasi saat ini (yaitu, dengan CoreWindow).
Show()	Menampilkan panel pengaturan akun.
ShowAddAccountAsync()	Menampilkan layar tambahkan akun.
ShowAddAccountForUserAsync(User)	Menampilkan layar tambahkan akun untuk pengguna yang ditentukan.
ShowManageAccountsAsync()	Menampilkan layar kelola akun.
ShowManageAccountsForUserAsync(User)	Menampilkan layar kelola akun untuk pengguna yang ditentukan.

Acara

AccountCommandsRequested

Terjadi saat pengguna membuka panel akun. Menangani peristiwa ini memungkinkan aplikasi menginisialisasi perintah akun dan menjeda UI-nya hingga pengguna menutup panel.

Berlaku untuk

Share via