WEKF_Scancode

Bloque ou débloque les combinaisons de touches à l’aide du code d’analyse du clavier, qui est un nombre entier généré chaque fois qu’une touche est enfoncée ou relâchée.

Syntaxe

class WEKF_Scancode {
    [Static] uint32 Add(
        [In] string Modifiers,
        [In] uint16 scancode
    );
    [Static] uint32 Remove(
        [In] string Modifiers,
        [In] uint16 Scancode
    );

    [Key] string Modifiers;
    [Key] uint16 Scancode;
    [Read, Write] boolean Enabled;
}

Membres

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

Méthodes

Méthodes	Description
WEKF_Scancode.Add	Ajoute une nouvelle combinaison de code d’analyse personnalisée et active le filtre clavier pour bloquer la nouvelle combinaison de codes d’analyse.
WEKF_Scancode.Remove	Supprime la combinaison de code d’analyse personnalisée spécifiée. Le filtre clavier cesse de bloquer la combinaison de codes d’analyse qui a été supprimée.

Propriétés

Propriété	Type de données	Qualificateurs	Description
Modificateurs	string	[Clé]	Touches de modification qui font partie de la combinaison de touches à bloquer.
Scancode	uint16	[Clé]	Partie de code d’analyse de la combinaison de touches à bloquer.
Activé	Booléen	[lecture, écriture]	Indique si le code d’analyse est bloqué ou débloqué. Cette propriété peut être l’une des valeurs suivantes : - true Indique que le code d’analyse est bloqué. - Faux Indique que le code d’analyse n’est pas bloqué.

Remarques

Les codes d’analyse sont générés par le clavier chaque fois qu’une touche est enfoncée. La même touche physique génère toujours le même code d’analyse, quelle que soit la disposition du clavier actuellement utilisée par le système.

Vous pouvez spécifier des combinaisons de touches en incluant les touches de modification dans le paramètre Modificateurs de la méthode Add ou en modifiant la propriété Modificateurs . Les noms de modificateurs les plus courants sont « Ctrl », « Maj », « Alt » et « Win ».

Exemple

Le code suivant montre comment ajouter ou activer un code d’analyse du clavier 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_Scancode.

<#
.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-Scancode($Modifiers, [int]$Code) {
    <#
    .Synopsis
        Toggle on a Scancode Keyboard Filter Rule
    .Description
        Use Get-WMIObject to enumerate all WEKF_Scancode instances,
        filter against key values of "Modifiers" and "Scancode", and set
        that instance's "Enabled" property to 1/true.

        In the case that the Scancode instance does not exist, add a new
        instance of WEKF_Scancode using Set-WMIInstance.
    .Example
        Enable-Predefined-Key "Ctrl+V"

        Enable filtering of the Ctrl + V sequence.
#>

    $scancode =
        Get-WMIObject -class WEKF_Scancode @CommonParams |
            where {
                ($_.Modifiers -eq $Modifiers) -and ($_.Scancode -eq $Code)
            }

    if($scancode) {
        $scancode.Enabled = 1
        $scancode.Put() | Out-Null
        "Enabled Custom Scancode {0}+{1:X4}" -f $Modifiers, $Code
    } else {
        Set-WMIInstance `
            -class WEKF_Scancode `
            -argument @{Modifiers="$Modifiers"; Scancode=$Code} `
            @CommonParams | Out-Null
 
        "Added Custom Scancode {0}+{1:X4}" -f $Modifiers, $Code
    }
}

# Some example uses of the function defined above.

Enable-Scancode "Ctrl" 37

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

Filtre de clavier