WEKF_CustomKey

Aggiunge o rimuove combinazioni di tasti personalizzate.

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 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 al filtro della tastiera di bloccare la nuova combinazione di tasti.
WEKF_CustomKey.Remove	Rimuove la combinazione di tasti personalizzata specificata. Il filtro della tastiera smette di bloccare la combinazione di tasti che è stata rimossa.

Proprietà

Proprietà	Tipo di dati	Qualificatori	Descrizione
Id	string	[key]	Nome della combinazione di tasti personalizzata.
Abilitato	Boolean	[lettura, scrittura]	Indica se la chiave è bloccata o sbloccata. Questa proprietà può essere uno dei valori - seguenti true Indica che la chiave è bloccata. - false 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 modificabili. Ad esempio, è possibile bloccare una combinazione di tasti di "CTRL+MAIUSC+F", ma non è possibile bloccare una combinazione di tasti "A+D".

Quando si blocca un tasto modificato da MAIUSC, è 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". Il tentativo di bloccare "%", comporta invece il blocco del filtro della tastiera "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 da tastiera bloccherà usando i provider strumentazione gestione Windows (WMI) per il filtro da tastiera. In questo esempio vengono modificate direttamente le proprietà e non viene chiamato alcun metodo definito 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"

Requisiti

Edizione per Windows	Supportata
Windows Home	No
Windows Pro	No
Windows Enterprise	Sì
Windows Education	Sì
Windows IoT Enterprise	Sì

Argomenti correlati

Informazioni di riferimento sul provider WMI del filtro della tastiera

Nomi dei tasti di filtro della tastiera