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

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 du clavier cesse de bloquer la combinaison de touches qui a été 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é	Booléen	[lecture, écriture]	Indique si la clé est bloquée ou débloquée. Cette propriété peut être l’une des valeurs - suivantes true Indique que la clé est bloquée. - Faux Indique que la clé n’est pas bloquée.

Remarques

Vous pouvez spécifier des combinaisons de touches en incluant les touches de modification dans le nom. Les noms de modificateurs 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 de « A+D ».

Lorsque vous bloquez une touche modifiée par décalage, vous devez entrer la touche « Maj » + la clé non modifiée. Par exemple, pour bloquer la touche % sur une disposition de clavier en 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 Noms de touches de filtre clavier.

Exemple

Le code suivant montre comment ajouter ou activer une combinaison de touches personnalisée que le filtre clavier bloquera à l’aide des fournisseurs WMI (Windows Management Instrumentation) pour le filtre 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"

Configuration requise

Édition Windows	Prise en charge
Windows Famille	Non
Windows Professionnel	Non
Windows Entreprise	Oui
Windows Éducation	Oui
Windows IoT Entreprise	Oui

Rubriques connexes

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

Noms de touches de filtre clavier