WEKF_CustomKey

• Aplica-se a:

  ✅ Windows 11, ✅ Windows 10

Adiciona ou remove combinações de teclas definidas de forma personalizada.

Sintaxe

class WEKF_CustomKey {
    [Static] uint32 Add(
        [In] string CustomKey
    );
    [Static] uint32 Remove(
        [In] string CustomKey
    );

    [Key] string Id;
    [Read, Write] boolean Enabled;
};

Membros

As tabelas a seguir listam todos os métodos e propriedades que pertencem a essa classe.

Métodos

Métodos	Descrição
WEKF_CustomKey.Adicionar	Cria uma combinação de teclas personalizadas e permite que o Filtro de Teclado bloqueie a nova combinação de teclas.
WEKF_CustomKey.Remover	Remove a combinação de teclas personalizada especificada. O Filtro de Teclado pára de bloquear a combinação de teclas que foi removida.

Propriedades

Propriedade	Tipo de dados	Qualificadores	Descrição
Id	string	[key]	O nome da combinação de teclas personalizada.
Enabled	Booliano	[ler, escrever]	Indica se a chave está bloqueada ou desbloqueada. Essa propriedade pode ser um dos seguintes valores - : true Indica que a chave está bloqueada. - false Indica que a chave não está bloqueada.

Comentários

Você pode especificar combinações de teclas incluindo as teclas modificadoras no nome. Os nomes de modificadores mais comuns são "Ctrl", "Shift", "Alt" e "Win". Não é possível bloquear uma combinação de teclas não modificadoras. Por exemplo, você pode bloquear uma combinação de teclas de "Ctrl+Shift+F", mas não pode bloquear uma combinação de teclas de "A+D".

Quando você bloqueia uma tecla modificada por turno, você deve inserir a tecla como "Shift" + a tecla não modificada. Por exemplo, para bloquear a tecla % em um layout de teclado em inglês, você deve especificar a tecla como "Shift+5". A tentativa de bloquear "%" resulta no bloqueio "5" do Filtro de Teclado.

Ao especificar a combinação de teclas a ser bloqueada, você deve usar os nomes em inglês para as teclas. Para obter uma lista dos nomes de teclas que você pode especificar, consulte Nomes de teclas do Filtro de Teclado.

Exemplo

O código a seguir demonstra como adicionar ou habilitar uma combinação de teclas personalizada que o filtro de teclado bloqueará usando os provedores WMI (Instrumentação de Gerenciamento do Windows) para filtro de teclado. Este exemplo modifica as propriedades diretamente e não chama nenhum dos métodos definidos em WEKF_CustomKey.

<#
.Synopsis
    This script shows how to use the WMI provider to enable and add 
    Keyboard Filter rules through Windows PowerShell on the local computer.
.Parameter ComputerName
    Optional parameter to specify a remote machine that this script should
    manage.  If not specified, the script will execute all WMI operations
    locally.
#>
param (
    [String] $ComputerName
)

$CommonParams = @{"namespace"="root\standardcimv2\embedded"}
$CommonParams += $PSBoundParameters

function Enable-Custom-Key($Id) {
    <#
    .Synopsis
        Toggle on a Custom Key Keyboard Filter Rule
    .Description
        Use Get-WMIObject to enumerate all WEKF_CustomKey instances,
        filter against key value "Id", and set that instance's "Enabled"
        property to 1/true.

        In the case that the Custom instance does not exist, add a new
        instance of WEKF_CustomKey using Set-WMIInstance.
    .Example
        Enable-Custom-Key "Ctrl+V"

        Enable filtering of the Ctrl + V sequence.
#>

    $custom = Get-WMIObject -class WEKF_CustomKey @CommonParams |
        where {
            $_.Id -eq "$Id"
        };

    if ($custom) {
# Rule exists.  Just enable it.
        $custom.Enabled = 1;
        $custom.Put() | Out-Null;
        "Enabled Custom Filter $Id.";

    } else {
        Set-WMIInstance `
            -class WEKF_CustomKey `
            -argument @{Id="$Id"} `
            @CommonParams | Out-Null

        "Added Custom Filter $Id.";
    }
}


# Some example uses of the function defined above.

Enable-Custom-Key "Ctrl+V"
Enable-Custom-Key "Numpad0"
Enable-Custom-Key "Shift+Numpad1"

Requisitos

Edição do Windows	Com suporte
Windows Home	Não
Windows Pro	Não
Windows Enterprise	Sim
Educação do Windows	Sim
Windows IoT Enterprise	Yes

Tópicos relacionados

Referência do provedor WMI do filtro de teclado

Nomes das teclas do Filtro de Teclado