WEKF_CustomKey

Agrega o quita combinaciones de teclas definidas por el personalizado.

Sintaxis

class WEKF_CustomKey {
    [Static] uint32 Add(
        [In] string CustomKey
    );
    [Static] uint32 Remove(
        [In] string CustomKey
    );

    [Key] string Id;
    [Read, Write] boolean Enabled;
};

Miembros

En las tablas siguientes se enumeran todos los métodos y propiedades que pertenecen a esta clase.

Métodos

Métodos	Descripción
WEKF_CustomKey.Add	Crea una nueva combinación de teclas y habilita que el filtro del teclado bloquee la nueva combinación de teclas.
WEKF_CustomKey.Remove	Quita la combinación de teclas personalizada especificada. El filtro de teclado deja de bloquear la combinación de teclas que se quitó.

Propiedades

Propiedad	Tipo de datos	Calificadores	Descripción
Id	string	[key]	Nombre de la combinación de teclas personalizada.
Habilitado	Booleano	[lectura, escritura]	Indica si la clave está bloqueada o desbloqueada. Esta propiedad puede ser uno de los siguientes valores - true Indica que la clave está bloqueada. - false Indica que la clave no está bloqueada.

Comentarios

Puede especificar combinaciones de teclas mediante la inclusión de las teclas modificadoras en el nombre. Los nombres modificadores más comunes son "Ctrl", "Mayús", "Alt" y "Win". No se puede bloquear una combinación de claves no modificadoras. Por ejemplo, puede bloquear una combinación de teclas de "Ctrl+Mayús+F", pero no puede bloquear una combinación de teclas de "A+D".

Al bloquear una tecla modificada por mayús, debe escribir la tecla como "Mayús" + la clave sin modificar. Por ejemplo, para bloquear la tecla % en un diseño de teclado en inglés, debe especificar la tecla como "Mayús+5". Al intentar bloquear "%", se produce el bloqueo del filtro de teclado "5" en su lugar.

Al especificar la combinación de teclas que se va a bloquear, debe usar los nombres en inglés para las claves. Para obtener una lista de los nombres de clave que puede especificar, consulte Nombres de teclas de filtro de teclado.

Ejemplo

En el código siguiente se muestra cómo agregar o habilitar una combinación de teclas personalizada que bloqueará el filtro de teclado mediante los proveedores de Instrumental de administración de Windows (WMI) para el filtro de teclado. En este ejemplo se modifican las propiedades directamente y no se llama a ninguno de los métodos definidos en 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"

Requisitos

Edición de Windows	Compatible
Windows Home	No
Windows Pro	No
Windows Enterprise	Sí
Windows Education	Sí
Windows IoT Enterprise	Sí

Temas relacionados

Referencia del proveedor WMI de filtro de teclado

Nombres de teclas de filtro de teclado