Partager via

WEKF_CustomKey

  • Article

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

Méthodes Description
WEKF_CustomKey.Add Crée une combinaison de touches personnalisée, et active le filtre clavier pour bloquer la nouvelle combinaison de touches.
WEKF_CustomKey.Remove Supprime la combinaison de touches personnalisée spécifiée. Le filtre de clavier cesse de bloquer la combinaison de touches supprimée.

Propriétés

Propriété Type de données Qualificateurs Description
Id string [Clé] Nom de la combinaison de touches personnalisée.
Activé Boolean [lecture, écriture] Indique si la clé est bloquée ou déblocée. Cette propriété peut être l’une des valeurs
- suivantes true Indique que la clé est bloquée.
- false Indique que la clé n’est pas bloquée.

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

Édition Windows Pris en charge
Windows Édition familiale Non
Windows Pro Non
Windows Entreprise Oui
Windows Éducation Oui
Windows IoT Entreprise Oui

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

Noms de touches de filtre de clavier