WEKF_CustomKey

Ajoute ou supprime des combinaisons de touches définies personnalisées.

Syntaxe

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

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

Membres

Les tableaux suivants répertorient toutes les méthodes et propriétés qui appartiennent à cette classe.

Méthodes

Propriétés

Notes

Vous pouvez spécifier des combinaisons de touches en incluant les touches de modification dans le nom. Les noms de modificateur les plus courants sont « Ctrl », « Maj », « Alt » et « Win ». Vous ne pouvez pas bloquer une combinaison de touches non modificateurs. Par exemple, vous pouvez bloquer une combinaison de touches « Ctrl+Maj+F », mais vous ne pouvez pas bloquer une combinaison de touches « A+D ».

Lorsque vous bloquez une touche modifiée par maj, vous devez entrer la clé en tant que « Maj » + la clé non modifiée. Par exemple, pour bloquer la touche % sur une disposition de clavier anglais, vous devez spécifier la touche « Maj+5 ». Si vous tentez de bloquer « % », le filtre clavier bloque « 5 » à la place.

Lorsque vous spécifiez la combinaison de touches à bloquer, vous devez utiliser les noms anglais pour les clés. Pour obtenir la liste des noms de clés que vous pouvez spécifier, consultez les noms de touches de filtre de clavier.

Exemple

Le code suivant montre comment ajouter ou activer une combinaison de touches personnalisée que le filtre de clavier bloquera à l’aide des fournisseurs WMI (Windows Management Instrumentation) pour le filtre de clavier. Cet exemple modifie directement les propriétés et n’appelle aucune des méthodes définies dans 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"

Spécifications

Rubriques connexes

Informations de référence sur le fournisseur WMI du filtre clavier

Noms de touches de filtre de clavier