Поделиться через

ShareWindowCommandSource Класс

  • Ссылка

Определение

Пространство имен:
Windows.UI.Shell
Изменить

Представляет объект, который приложение связи может использовать для настройки связи с оболочкой окна для представления пользовательского интерфейса для запуска и остановки общего доступа к окнам.

Получите экземпляр ShareWindowCommandSource и зарегистрируйтесь для обработки событий ShareWindowCommandSource.CommandRequested и ShareWindowCommandSource.CommandInvoked экземпляра. Эти события вызываются оболочкой Windows.

Важно!

API Windows.UI.Shell.ShareWindowCommandSource является частью функции ограниченного доступа (см. класс LimitedAccessFeatures). Для получения дополнительных сведений или запроса маркера разблокировки используйте форму запроса маркера доступа LAF.

public ref class ShareWindowCommandSource sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ShareWindowCommandSource final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ShareWindowCommandSource
Public NotInheritable Class ShareWindowCommandSource
Наследование
Object Platform::Object IInspectable ShareWindowCommandSource
Атрибуты
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств
Windows 11 (появилось в 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v14.0)

Комментарии

Эта функция дополняет функцию общего доступа к окнам, которую уже реализует приложение, предоставляя альтернативный метод выбора окон. Эта конструкция позволяет вашему приложению представлять команды начать общий доступ и прекратить общий доступ; и для реализации таких способов, которые соответствуют возможности вашего приложения совместно использовать одно или несколько окон.

Приложение для связи идентифицирует окно, соответствующее возможности совместного использования окон— одно окно приложения или окна, в которых размещаются сеансы связи (вызовы). Оболочка Windows использует это, чтобы:

  • Получение идентификационных сведений приложения, таких как его значок и имя, которые будут представлены с командами общего доступа.
  • Выберите один из нескольких источников команд общего доступа. Будет выбрано последнее используемое приложение для общего доступа.

События используются для запроса команд и их вызова, включая WindowId окна, к которым будет предоставлен общий доступ.

IShareWindowCommandSourceInterop — это собственный интерфейс взаимодействия, который позволяет получить объект ShareWindowCommandSource .

Методы

GetForCurrentView()

Статический метод, который можно использовать для получения экземпляра ShareWindowCommandSource.

Важно!

API ShareWindowCommandSource.GetForCurrentView является частью функции ограниченного доступа (см. класс LimitedAccessFeatures). Для получения дополнительных сведений или запроса маркера разблокировки используйте форму запроса маркера доступа LAF.
ReportCommandChanged()

Указывает оболочке Windows, что состояние общего доступа приложения для связи изменилось.

Вызывайте этот метод всякий раз, когда состояние общего доступа приложения для связи меняется. Если вы успешно предоставили общий доступ к новому окну в звонке или собрании или удалили уже общее окно (будь то через собственный пользовательский интерфейс или активируется действием панели задач Windows), необходимо уведомить экземпляр ShareWindowCommandSource об этом изменении, вызвав ReportCommandChanged.

Затем оболочка сбрасывает все сведения, полученные в рамках любого события ShareWindowCommandSource.CommandRequested , и обновит команды видимых общих ресурсов в соответствии с текущим состоянием приложения.
Start()

Указывает, что вызывающее приложение в настоящее время является источником команд общего доступа к окнам. Вызовите этот метод во время вызова или собрания, чтобы включить приложение для связи в качестве источника команд общего доступа к окнам.
Stop()

Указывает, что вызывающее приложение не является источником команд общего доступа к окнам. Вызовите этот метод, когда завершается вызов или собрание, чтобы отключить приложение для связи в качестве источника команд общего доступа к окнам.

События

CommandInvoked

Событие, которое вызывается оболочкой Windows, чтобы предоставить вашему приложению для связи возможность фактически запустить или прекратить совместное использование определенного окна.
CommandRequested

Событие, вызванное оболочкой Windows, чтобы предоставить приложению для связи возможность запуска или прекращения совместного использования определенного окна.

Применяется к

См. также раздел