Bagikan melalui

Desain perintah

  • Artikel

Saat Anda menambahkan perintah ke VSPackage, Anda harus menentukan di mana perintah tersebut muncul, kapan tersedia, dan bagaimana perintah tersebut akan ditangani.

Menentukan perintah

Untuk menentukan perintah baru, sertakan file tabel perintah Visual Studio (.vsct) dalam proyek VSPackage Anda. Jika Anda telah membuat VSPackage dengan menggunakan templat paket Visual Studio, proyek menyertakan salah satu file ini. Untuk informasi selengkapnya, lihat File tabel perintah Visual Studio (.vsct).

Visual Studio menggabungkan semua file .vsct yang ditemukannya sehingga dapat menampilkan perintah. Karena file-file ini berbeda dari biner VSPackage, Visual Studio tidak perlu memuat paket untuk menemukan perintah. Untuk informasi selengkapnya, lihat Cara VSPackages menambahkan elemen antarmuka pengguna.

Visual Studio menggunakan ProvideMenuResourceAttribute atribut pendaftaran untuk menentukan sumber daya dan perintah menu. Untuk informasi selengkapnya, lihat Implementasi perintah.

Perintah dapat diubah pada waktu proses dengan sejumlah cara yang berbeda. Mereka dapat ditampilkan atau disembunyikan, diaktifkan, atau dinonaktifkan. Mereka dapat menampilkan teks atau ikon yang berbeda, atau berisi nilai yang berbeda. Banyak penyesuaian dapat dilakukan sebelum Visual Studio memuat VSPackage Anda. Untuk informasi selengkapnya, lihat Cara VSPackages menambahkan elemen antarmuka pengguna.

Penangan perintah

Saat membuat perintah, Anda harus menyediakan penanganan aktivitas untuk menjalankan perintah. Jika pengguna memilih perintah , perintah harus dirutekan dengan tepat. Merutekan perintah berarti mengirimkannya ke VSPackage yang benar untuk mengaktifkan atau menonaktifkannya, menyembunyikan atau menampilkannya, dan menjalankannya jika pengguna memilih untuk melakukannya. Untuk informasi selengkapnya, lihat Algoritma perutean perintah.

Lingkungan perintah Visual Studio

Visual Studio dapat menghosting sejumlah VSPackage, dan masing-masing dapat berkontribusi pada set perintahnya sendiri. Lingkungan hanya menampilkan perintah yang sesuai dengan tugas saat ini. Untuk informasi selengkapnya, lihat Ketersediaan perintah dan Objek konteks pemilihan.

VSPackage yang menentukan perintah, menu, toolbar, atau menu pintasan baru menyediakan informasi perintahnya ke Visual Studio pada waktu penginstalan melalui entri registri yang mereferensikan sumber daya dalam rakitan asli atau terkelola. Setiap sumber daya kemudian mereferensikan file sumber daya data biner (.cto), yang diproduksi saat Anda mengkompilasi file tabel perintah Visual Studio (.vsct). Ini memungkinkan Visual Studio untuk menyediakan kumpulan perintah gabungan, menu, dan toolbar tanpa harus memuat setiap VSPackage yang diinstal.

Organisasi perintah

Lingkungan memposisikan perintah menurut grup, prioritas, dan menu.

  • Grup adalah kumpulan logis perintah terkait, misalnya, grup perintah Potong, Salin, dan Tempel . Grup adalah perintah yang muncul pada menu.

  • Prioritas menentukan urutan perintah individual dalam grup muncul di menu.

  • Menu bertindak sebagai kontainer untuk grup.

    Lingkungan telah menentukan beberapa perintah, grup, dan menu. Untuk informasi selengkapnya, lihat Penempatan perintah, grup, dan toolbar default.

    Perintah dapat ditetapkan ke grup utama. Grup utama mengontrol posisi perintah di struktur menu utama dan dalam kotak dialog Kustomisasi . Perintah dapat muncul di beberapa grup; misalnya, perintah dapat berada di menu utama, pada menu pintasan, dan pada toolbar. Untuk informasi selengkapnya, lihat Cara VSPackages menambahkan elemen antarmuka pengguna.

Perutean perintah

Proses perintah pemanggilan dan perutean untuk VSPackages berbeda dari proses metode panggilan pada instans objek.

Lingkungan merutekan perintah secara berurutan dari konteks perintah terdalam (lokal), yang didasarkan pada pilihan saat ini, ke konteks terluar (global). Konteks pertama yang dapat menjalankan perintah adalah konteks yang menanganinya. Untuk informasi selengkapnya, lihat Algoritma perutean perintah.

Dalam kebanyakan kasus, lingkungan menangani perintah dengan menggunakan IOleCommandTarget antarmuka . Karena skema perutean perintah memungkinkan banyak objek berbeda untuk menangani perintah, IOleCommandTarget dapat diimplementasikan oleh sejumlah objek; ini termasuk kontrol Microsoft ActiveX, implementasi tampilan jendela, objek dokumen, hierarki proyek, dan objek VSPackage itu sendiri (untuk perintah global). Dalam beberapa kasus khusus, misalnya, perintah perutean dalam hierarki, IVsHierarchy antarmuka harus diimplementasikan.

Judul Deskripsi
Implementasi perintah Menjelaskan cara menerapkan perintah dalam VSPackage.
Ketersediaan perintah Menjelaskan bagaimana konteks Visual Studio menentukan perintah mana yang tersedia.
Algoritma perutean perintah Menjelaskan bagaimana arsitektur perutean perintah Visual Studio memungkinkan perintah ditangani oleh VSPackage yang berbeda.
Panduan penempatan perintah Menyarankan cara memposisikan perintah di lingkungan Visual Studio.
Cara VSPackages menambahkan elemen antarmuka pengguna Menjelaskan bagaimana VSPackages dapat memanfaatkan arsitektur perintah Visual Studio dengan sebaik-baiknya.
Penempatan perintah, grup, dan toolbar default Menjelaskan cara terbaik VSPackages menggunakan perintah yang disertakan dalam Visual Studio.
Mengelola VSPackages Menjelaskan cara Visual Studio memuat VSPackages.
File tabel perintah Visual Studio (.vsct) Menyediakan informasi tentang file .vsct berbasis XML, yang digunakan untuk menjelaskan tata letak dan tampilan perintah di VSPackages.