WEKF_Scancode

Blocca o sblocca le combinazioni di tasti usando il codice di analisi della tastiera, ovvero un numero intero generato ogni volta che viene premuto o rilasciato un tasto.

Sintassi

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;
}

Members

Nelle tabelle seguenti sono elencati i costruttori, i metodi, i campi e le proprietà che appartengono a questa classe.

Metodi

Metodi	Descrizione
WEKF_Scancode.Add	Aggiunge una nuova combinazione di codice di analisi personalizzata e consente al filtro della tastiera di bloccare la nuova combinazione di codice di analisi.
WEKF_Scancode.Remove	Rimuove la combinazione di codice di analisi personalizzata specificata. Il filtro della tastiera interrompe il blocco della combinazione di codice di analisi rimossa.

Proprietà

Proprietà	Tipo di dati	Qualificatori	Descrizione
Modificatori	string	[key]	Tasti di modifica che fanno parte della combinazione di tasti da bloccare.
Scancode	uint16	[key]	Parte del codice di analisi della combinazione di tasti da bloccare.
Enabled	Boolean	[lettura, scrittura]	Indica se il codice di analisi è bloccato o sbloccato. Questa proprietà può essere uno dei valori seguenti: - true Indica che il codice di analisi è bloccato. - False Indica che il codice di analisi non è bloccato.

Commenti

I codici di analisi vengono generati dalla tastiera ogni volta che viene premuto un tasto. Lo stesso tasto fisico genererà sempre lo stesso codice di analisi, indipendentemente dal layout della tastiera attualmente utilizzato dal sistema.

È possibile specificare combinazioni di tasti includendo i tasti di modifica nel parametro Modificatori del metodo Add o modificando la proprietà Modificatori . I nomi dei modificatori più comuni sono "CTRL", "MAIUSC", "ALT" e "Win".

Esempio

Il codice seguente illustra come aggiungere o abilitare un codice di analisi da tastiera che il filtro da tastiera bloccherà usando i provider strumentazione gestione Windows (WMI) per il filtro da tastiera. Questo esempio modifica direttamente le proprietà e non chiama alcun metodo definito in 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

Requisiti

Edizione per Windows	Supportato
Windows Home	No
Windows Pro	No
Windows Enterprise	Sì
Windows Education	Sì
Windows IoT Enterprise	Sì

Argomenti correlati

Informazioni di riferimento sul provider WMI del filtro da tastiera

Filtro della tastiera