Compartilhar via


Alternar a disponibilidade de uma ação de aplicativo para Windows

Um provedor de Ação de Aplicativo do Windows pode especificar que uma ou mais de suas ações estão indisponíveis no momento. Esse recurso permite cenários como exigir um logon ou uma assinatura antes que uma ação seja disponibilizada para o usuário.

Definir disponibilidade inicial

Você pode especificar o status de disponibilidade inicial de uma ação de aplicativo fornecendo um valor para o campo isAvailable no arquivo JSON de definição de ação. O valor é opcional e o padrão é true. O exemplo a seguir ilustra o uso do campo isAvailable para tornar uma ação de aplicativo indisponível imediatamente após a instalação.

"version": 2,
"actions": [
   {
     "id": "ToDoList.ToDoActionHandler.AddToList",
     "description": "Add item to your to-do list",
     "icon": "ms-resource://Files/Assets/LockScreenLogo.png",
     "usesGenerativeAI": false,
     "isAvailable": false,
    ...

Para obter mais informações, consulte Esquema JSON de definição de ação para Ações de Aplicativo no Windows.

Alterar o estado de disponibilidade em runtime

Registre uma alteração no estado de disponibilidade de uma ou mais ações registradas com o sistema chamando ActionRuntime.SetActionAvailability.

void SetActionAvailability(bool actionIsAvailable)
{

    using (ActionRuntime runtime = new ActionRuntime())
    {
        runtime.SetActionAvailability("ExampleActionProvider.SendMessage", actionIsAvailable);
    }

}