WEKF_CustomKey
Menambahkan atau menghapus kombinasi kunci yang ditentukan khusus.
Sintaks
class WEKF_CustomKey {
[Static] uint32 Add(
[In] string CustomKey
);
[Static] uint32 Remove(
[In] string CustomKey
);
[Key] string Id;
[Read, Write] boolean Enabled;
};
Anggota
Tabel berikut mencantumkan metode dan properti apa pun yang termasuk dalam kelas ini.
Metode
| Metode | Deskripsi |
|---|---|
| WEKF_CustomKey.Add | Membuat kombinasi kunci kustom baru dan mengaktifkan Filter Keyboard untuk memblokir kombinasi tombol baru. |
| WEKF_CustomKey.Remove | Menghapus kombinasi kunci kustom yang ditentukan. Filter Keyboard berhenti memblokir kombinasi tombol yang dihapus. |
Properti
| Properti | Jenis Data | Kualifikasi | Deskripsi |
|---|---|---|---|
| Id | string | [kunci] | Nama kombinasi kunci kustom. |
| Aktif | Boolean | [baca, tulis] | Menunjukkan apakah kunci diblokir atau tidak diblokir. Properti ini bisa menjadi salah satu nilai - berikut yang benar Menunjukkan bahwa kunci diblokir.- Palsu Menunjukkan bahwa kunci tidak diblokir. |
Keterangan
Anda dapat menentukan kombinasi kunci dengan menyertakan tombol pengubah dalam nama. Nama pengubah yang paling umum adalah "Ctrl", "Shift", "Alt", dan "Win". Anda tidak dapat memblokir kombinasi tombol non-pengubah. Misalnya, Anda dapat memblokir kombinasi tombol "Ctrl+Shift+F", tetapi Anda tidak dapat memblokir kombinasi tombol "A+D".
Saat Anda memblokir kunci yang dimodifikasi shift, Anda harus memasukkan kunci sebagai "Shift" + kunci yang tidak dimodifikasi. Misalnya, untuk memblokir tombol % pada tata letak keyboard bahasa Inggris, Anda harus menentukan tombol sebagai "Shift+5". Mencoba memblokir "%", menghasilkan Filter Keyboard yang memblokir "5" sebagai gantinya.
Saat Anda menentukan kombinasi kunci untuk diblokir, Anda harus menggunakan nama bahasa Inggris untuk kunci. Untuk daftar nama kunci yang bisa Anda tentukan, lihat Nama kunci Filter Keyboard.
Contoh
Kode berikut menunjukkan cara menambahkan atau mengaktifkan kombinasi tombol kustom yang akan diblokir Filter Keyboard dengan menggunakan penyedia Windows Management Instrumentation (WMI) untuk Filter Keyboard. Contoh ini memodifikasi properti secara langsung dan tidak memanggil metode apa pun yang ditentukan dalam 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"
Persyaratan
| Edisi Windows | Didukung |
|---|---|
| Windows Home | Tidak |
| Windows Pro | Tidak |
| Windows Enterprise | Ya |
| Windows Education | Ya |
| Windows IoT Enterprise | Ya |