Bagikan melalui

Mengikat pintasan keyboard ke item menu

  • Artikel

Untuk mengikat pintasan keyboard ke perintah menu kustom, cukup tambahkan entri ke file .vsct untuk paket tersebut. Topik ini menjelaskan cara memetakan pintasan keyboard ke tombol kustom, item menu, atau perintah toolbar, dan cara menerapkan pemetaan keyboard di editor default atau membatasinya ke editor kustom.

Untuk menetapkan pintasan keyboard ke item menu Visual Studio yang sudah ada, lihat Mengidentifikasi dan menyesuaikan pintasan keyboard.

Pilih kombinasi kunci

Banyak pintasan keyboard yang sudah digunakan di Visual Studio. Anda tidak boleh menetapkan pintasan yang sama ke lebih dari satu perintah karena pengikatan duplikat sulit dideteksi dan juga dapat menyebabkan hasil yang tidak dapat diprediksi. Oleh karena itu, ada baiknya untuk memverifikasi ketersediaan pintasan sebelum Anda menetapkannya.

Untuk memverifikasi ketersediaan pintasan keyboard

  1. Di jendela Lingkungan Opsi>Alat>, pilih Keyboard.

  2. Pastikan bahwa Gunakan pintasan baru di diatur ke Global.

  3. Dalam kotak Tekan tombol pintasan, ketik pintasan keyboard yang ingin Anda gunakan.

    Jika pintasan sudah digunakan di Visual Studio, kotak Pintasan yang saat ini digunakan oleh akan menampilkan perintah yang saat ini dipanggil pintasan.

  4. Coba kombinasi kunci yang berbeda sampai Anda menemukan yang tidak dipetakan.

    Catatan

    Pintasan keyboard yang menggunakan Alt dapat membuka menu dan tidak langsung menjalankan perintah. Oleh karena itu, kotak Pintasan yang saat ini digunakan oleh mungkin kosong saat Anda mengetik pintasan yang menyertakan Alt. Anda dapat memverifikasi bahwa pintasan tidak membuka menu dengan menutup kotak dialog Opsi lalu menekan tombol.

    Prosedur berikut mengasumsikan bahwa Anda memiliki VSPackage yang ada dengan perintah menu. Jika Anda memerlukan bantuan untuk melakukannya, lihat Membuat ekstensi dengan perintah menu.

Untuk menetapkan pintasan keyboard ke perintah

  1. Buka file .vsct untuk paket Anda.

  2. Buat bagian kosong <KeyBindings> setelah <Commands> jika belum ada.

    Peringatan

    Untuk informasi selengkapnya tentang pengikatan kunci, lihat Keybinding.

    Di bagian , <KeyBindings> buat <KeyBinding> entri.

    Atur guid atribut dan id ke atribut perintah yang ingin Anda panggil.

    Atur atribut ke mod1 Kontrol, Alt, atau Shift.

    Bagian KeyBindings akan terlihat seperti ini:

    <KeyBindings>
    <KeyBinding guid="<name of command set>" id="<name of command id>"
        editor="guidVSStd97" key1="1" mod1="CONTROL"/>
</KeyBindings>

    Jika pintasan keyboard Anda memerlukan lebih dari dua tombol, atur mod2 atribut dan key2 .

    Dalam kebanyakan situasi, Shift tidak boleh digunakan tanpa pengubah kedua karena menekannya sudah menyebabkan sebagian besar tombol alfanumerik mengetik huruf besar atau simbol.

    Kode kunci virtual memungkinkan Anda mengakses kunci khusus yang tidak memiliki karakter yang terkait dengannya, misalnya, kunci fungsi dan kunci Backspace . Untuk informasi selengkapnya, lihat Kode kunci virtual.

    Untuk membuat perintah tersedia di editor Visual Studio, atur atribut ke editor guidVSStd97.

    Untuk membuat perintah hanya tersedia di editor kustom, atur editor atribut ke nama editor kustom yang dihasilkan oleh Templat Paket Visual Studio saat Anda membuat VSPackage yang menyertakan editor kustom. Untuk menemukan nilai nama, lihat di bagian <Symbols> untuk simpul <GuidSymbol> yang atributnya name berakhiran "editorfactory." Ini adalah nama editor kustom.

Contoh 1

Contoh ini mengikat pintasan keyboard Ctrl+Alt+C ke perintah bernama cmdidMyCommand dalam paket bernama .MyPackage

<CommandTable>
. . .
<Commands>
. . .
</Commands>
<KeyBindings>
  <KeyBinding guid="guidMyPackageCmdSet" id="cmdidMyCommand"
      key1="C" mod1="CONTROL" mod2="ALT" editor="guidVSStd97" />
</KeyBindings>
. . .
</CommandTable>

Contoh 2

Contoh ini mengikat pintasan keyboard Ctrl+B ke perintah bernama cmdidBold dalam proyek bernama .TestEditor Perintah hanya tersedia di editor kustom dan bukan di editor lain.

<KeyBinding guid="guidVSStd97" id="cmdidBold" editor="guidTestEditorEditorFactory" key1="B" mod1="Control" />

Konten terkait