AccountsSettingsPane Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет методы для отображения области учетных записей, а также для того, чтобы приложение регистрировало обратные вызовы, когда появится всплывающий элемент учетных записей.
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- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
Приложение предоставляет обратные вызовы с метаданными учетной записи для всех поставщиков учетных записей в Интернете, веб-учетных записей, глобальных команд учетных записей и учетных данных хранилища учетных данных, отображаемых приложением. Примерами поставщиков учетных записей являются Facebook, LinkedIn и Twitter.
Классы команд учетных записей и учетных данных в пространстве имен Windows.UI.ApplicationSettings соответствуют объектам данных в пространстве имен Windows.UI.ApplicationSettings :
| Объект данных (Windows.Security.Credentials) | Объект пользовательского интерфейса (Windows.UI.ApplicationSettings) |
|---|---|
| WebAccount | WebAccountCommand |
| WebAccountProvider | WebAccountProviderCommand |
| PasswordCredential | CredentialCommand |
Классические приложения
Для классического приложения вместо класса AccountSettingsPane необходимо использовать API взаимодействия, как описано ниже.
- Сначала получите дескриптор окна (HWND). Этот раздел содержит примеры кода для библиотеки пользовательского интерфейса Windows (WinUI) 3, Windows Presentation Foundation (WPF) и Windows Forms (WinForms). Вставьте этот код в приведенный ниже код.
- В классическом приложении следует использовать интерфейс IAccountSettingsPaneInterop . Для приложений C#, использующих .NET 6 или более поздней версии, доступен класс AccountSettingsPaneInterop . Дополнительные сведения о классах взаимодействия C# см. в статье Вызов API взаимодействия из приложения .NET 5 и более поздних версий. См. также статью Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.
Ниже приведен пример использования класса AccountSettingsPaneInterop в C# (.NET 6 или более поздней версии):
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);
}
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1607 | 14393 | ShowAddAccountAsync |
| 1607 | 14393 | ShowManageAccountsAsync |
| 1803 | 17134 | ShowAddAccountForUserAsync |
| 1803 | 17134 | ShowManageAccountsForUserAsync |
Методы
| GetForCurrentView() |
Возвращает объект AccountsSettingsPane , связанный с текущим представлением приложения (то есть с CoreWindow). |
| Show() |
Отображает панель параметров учетной записи. |
| ShowAddAccountAsync() |
Отображает экран добавления учетных записей. |
| ShowAddAccountForUserAsync(User) |
Отображает экран добавления учетных записей для указанного пользователя. |
| ShowManageAccountsAsync() |
Отображает экран управления учетными записями. |
| ShowManageAccountsForUserAsync(User) |
Отображает экран управления учетными записями для указанного пользователя. |
События
| AccountCommandsRequested |
Происходит при открытии пользователем области учетных записей. Обработка этого события позволяет приложению инициализировать команды учетных записей и приостанавливать пользовательский интерфейс, пока пользователь не закроет панель. |