Compartilhar via

WEKF_CustomKey

Edições
✅ Suportadas IoT Enterprise LTSC
✅ IoT Enterprise
✅ LTSC✅
Enterprise
✅ Education

Adiciona ou remove combinações de teclas definidas personalizadas.

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 seguintes listam todos os métodos e propriedades que pertencem a esta classe.

Métodos

Métodos Descrição
WEKF_CustomKey.Add Cria uma nova combinação de teclas personalizadas e permite que o Filtro de Teclado bloqueie a nova combinação de teclas.
WEKF_CustomKey.Remove Remove a combinação de teclas personalizadas especificada. O Filtro de Teclado deixa de bloquear a combinação de teclas que foi removida.

Propriedades

Propriedade Tipo de dados Qualificadores Descrição
ID string [chave] O nome da combinação de teclas personalizadas.
Habilitada Booliano [ler, escrever] Indica se a chave está bloqueada ou desbloqueada. Esta propriedade pode ser um dos seguintes valores
- verdadeiro Indica que a chave está bloqueada.
- falso Indica que a chave não está bloqueada.

Comentários

Pode especificar combinações de teclas ao incluir as teclas modificadoras no nome. Os nomes dos modificadores mais comuns são >Ctrl, >Shift, >Alt e >Win. Não pode bloquear uma combinação de teclas não modificadoras. Por exemplo, pode bloquear uma combinação de teclas ctrl>+>Shift+>F, mas não pode bloquear uma combinação de teclas de >A+>D.

Quando bloquear uma >tecla Modificada por Shift, tem de introduzir a tecla como >Shift + a chave não modificada. Por exemplo, para bloquear a > tecla % num esquema de teclado inglês, tem de especificar a tecla como >Shift+>5. Tentar bloquear >%, resulta no bloqueio do Filtro > de Teclado 5.

Quando especificar a combinação de teclas a bloquear, tem de utilizar os nomes em inglês para as teclas. Para obter uma lista dos nomes de teclas que pode especificar, consulte Nomes de teclas de Filtro de Teclado.

Exemplo

O código seguinte demonstra como adicionar ou ativar uma combinação de teclas personalizada que o Filtro de Teclado bloqueará utilizando os fornecedores do Windows Management Instrumentation (WMI) para o Filtro de Teclado. Este exemplo modifica as propriedades diretamente e não chama nenhum dos métodos definidos no 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"

Referência do fornecedor WMI de Filtro de Teclado

Nomes de teclas filtro de teclado