Condividi tramite

WEKF_CustomKey

Edizioni
✅ supportate IoT Enterprise LTSC
✅ IoT Enterprise
✅ LTSC✅
Enterprise
✅ Education

Aggiunge o rimuove combinazioni di tasti definite in modo personalizzato.

Sintassi

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

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

Membri

Nelle tabelle seguenti sono elencati tutti i metodi e le proprietà che appartengono a questa classe.

Metodi

Metodi Descrizione
WEKF_CustomKey.Add Crea una nuova combinazione di tasti personalizzata e consente a Filtro tastiera di bloccare la nuova combinazione di tasti.
WEKF_CustomKey.Remove Rimuove la combinazione di tasti personalizzata specificata. Filtro tastiera interrompe il blocco della combinazione di tasti rimossa.

Proprietà

Proprietà Tipo di dati Qualificazioni Descrizione
Id stringa [chiave] Nome della combinazione di tasti personalizzata.
Abilitato Booleano [lettura, scrittura] Indica se la chiave è bloccata o sbloccata. Questa proprietà può essere uno dei valori
- seguenti true Indica che la chiave è bloccata.
- falso Indica che la chiave non è bloccata.

Osservazioni

È possibile specificare combinazioni di tasti includendo i tasti di modifica nel nome. I nomi dei modificatori più comuni sono >CTRL, >MAIUSC, >ALT e >WIN. Non è possibile bloccare una combinazione di tasti non modificatori. Ad esempio, è possibile bloccare una combinazione di tasti CTRL>+>MAIUSC+>F, ma non è possibile bloccare una combinazione di tasti A>+>D.

Quando si blocca un> tasto maiusc modificato, è necessario immettere il tasto maiusc> + il tasto non modificato. Ad esempio, per bloccare il >tasto % in un layout di tastiera inglese, è necessario specificare il tasto maiusc>+>5. Se si tenta di bloccare >%, il filtro della >tastiera blocca invece 5 .

Quando si specifica la combinazione di tasti da bloccare, è necessario usare i nomi in inglese per le chiavi. Per un elenco dei nomi di chiave che è possibile specificare, vedere Nomi dei tasti di filtro della tastiera.

Esempio

Il codice seguente illustra come aggiungere o abilitare una combinazione di tasti personalizzata che il filtro tastiera bloccherà usando i provider di Strumentazione gestione Windows (WMI) per Filtro tastiera. In questo esempio vengono modificate direttamente le proprietà e non vengono chiamati i metodi definiti in 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"

Informazioni di riferimento sul provider WMI filtro tastiera

Nomi dei tasti filtro tastiera