Partager via

WEKF_CustomKey

Éditions
✅ prises en charge IoT Enterprise LTSC
✅ IoT Enterprise
✅ LTSC✅
Enterprise
✅ Éducation

Ajoute ou supprime des combinaisons de touches 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 Qualificatifs Description
Id chaîne [key] Nom de la combinaison de touches personnalisée.
Activé Booléen [lire, écrire] Indique si la clé est bloquée ou débloquée. Cette propriété peut avoir 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 de >Ctrl+>Maj+>F, mais vous ne pouvez pas bloquer une combinaison de touches D>+>.

Lorsque vous bloquez une> touche maj modifiée, vous devez entrer la touche Maj> + la touche 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 des 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"

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

Noms des touches de filtre clavier