Panduan penempatan perintah

Praktik terbaik untuk memposisikan perintah di lingkungan pengembangan terintegrasi Visual Studio (IDE) bervariasi tergantung pada ukuran set perintah. Perintah didefinisikan dan diposisikan sesuai dengan informasi dalam file .vsct .

Praktik terbaik untuk semua kumpulan perintah

Untuk setiap set perintah, ikuti panduan berikut:

  • Siapkan bagan struktur perintah terlebih dahulu. Identifikasi perintah, kotak kombo, grup perintah, dan menu pintasan yang akan digunakan di lebih dari satu lokasi.

  • Perintah yang muncul dalam grup yang sama harus terkait.

  • Grup yang hanya berisi satu perintah dapat diterima.

  • Paket tidak boleh menambahkan banyak perintah ke menu Visual Studio yang ada. Sebagai gantinya, mereka harus membuat menu atau submenu untuk menghosting perintah baru.

  • Ketika Anda meletakkan perintah pada menu yang ada, beri nama perintah sehingga tujuannya jelas dan tidak akan bingung dengan perintah yang ada.

Praktik terbaik untuk set perintah sederhana

Jika Anda mengembangkan VSPackage yang hanya memiliki beberapa perintah, ikuti juga panduan berikut:

  • Jika memungkinkan, gunakan elemen Induk dari perintah, kotak kombo, grup, atau menu turunan untuk memasukkannya ke dalam grup yang sesuai.

  • Tetapkan grup ini ke menu yang ditampilkan oleh VSPackage.

  • Induk menu turunan atau perintah harus berupa elemen Grup . Tetapkan perintah dan menu turunan ke grup, lalu tetapkan grup ke menu induk.

  • Anda dapat menempatkan perintah di grup tambahan dengan menambahkan bagian elemen CommandPlacements setelah definisi perintah, lalu menambahkan ke CommandPlacements elemen elemen CommandPlacement untuk setiap grup tambahan.

Praktik terbaik untuk kumpulan perintah besar

Jika VSPackage Anda akan memiliki banyak perintah yang akan muncul dalam beberapa konteks, ikuti juga panduan berikut:

  • Buat menu, grup, dan perintah self-parenting. Artinya, jangan menetapkan Parent elemen dalam definisi item.

  • Gunakan CommandPlacement entri elemen di bagian CommandPlacements elemen untuk menempatkan menu, grup, dan perintah di menu dan grup induknya.

  • Di bagian CommandPlacements elemen, entri yang mengisi menu atau grup tertentu harus berdekatan satu sama lain. Ini membantu keterbacaan dan membuat Priority peringkat lebih mudah ditentukan.