Bagikan melalui


IMenuCommandService.AddCommand(MenuCommand) Metode

Definisi

Menambahkan perintah menu standar yang ditentukan ke menu.

public:
 void AddCommand(System::ComponentModel::Design::MenuCommand ^ command);
public void AddCommand (System.ComponentModel.Design.MenuCommand command);
abstract member AddCommand : System.ComponentModel.Design.MenuCommand -> unit
Public Sub AddCommand (command As MenuCommand)

Parameter

command
MenuCommand

yang MenuCommand akan ditambahkan.

Pengecualian

CommandID Dari yang ditentukan MenuCommand sudah ada pada menu.

Keterangan

Enumerasi MenuCommands dan StandardCommands berisi CommandID pengidentifikasi untuk perintah standar dan perintah menu yang telah ditentukan sebelumnya yang sudah terkait dengan lokasi pada menu tertentu.

Catatan

Upaya untuk menambahkan perintah menu dengan yang sudah ada CommandID akan melemparkan InvalidOperationException. Saat menambahkan perintah menu, pastikan untuk memeriksa bahwa itu belum ada di menu menggunakan FindCommand metode , atau gunakan penanganan pengecualian dengan bijak.

Anda dapat melampirkan penanganan aktivitas ke perintah menu yang telah ditentukan sebelumnya dengan prosedur berikut:

  1. Jika perintah menu untuk menautkan dengan penanganan aktivitas telah ditambahkan ke menu, atau terletak dengan FindCommand metode , pertimbangkan apakah Anda ingin memulihkan perintah menu ini nanti, dan apakah Anda ingin memanggil penanganan aktivitas saat ini dari penanganan aktivitas baru Anda. Jika kode Anda dapat memulihkan perintah menu atau menautkan pemanggilan penanganan aktivitas, pastikan untuk menyimpan referensi ke perintah menu di suatu tempat.

  2. Pastikan bahwa perintah menu yang ada sebelumnya dengan perintah yang sama CommandID telah dihapus dari menu menggunakan RemoveCommand metode .

  3. Buat baru MenuCommand dan tentukan penanganan aktivitas Anda di konstruktor, bersama dengan yang CommandID mewakili perintah untuk ditambahkan. Setiap perintah menu standar dikaitkan dengan lokasi menu yang telah ditentukan sebelumnya tempatnya ditambahkan. ID perintah yang didukung ditentukan dalam StandardCommands enumerasi dan MenuCommands .

  4. Jika Anda ingin memanggil penanganan aktivitas yang sudah ada sebelumnya untuk perintah menu, panggil Invoke metode perintah menu yang telah Anda ganti pada menu dari penanganan aktivitas yang menangani peristiwa pemanggilan perintah menu Anda.

  5. Jika Anda tertarik untuk memulihkan penanganan aktivitas dari perintah menu yang sudah ada sebelumnya yang telah Anda ganti, tambahkan perintah menu yang disimpan dan sudah ada sebelumnya setelah Anda menghapus perintah menu pengganti yang Anda buat. Anda mungkin ingin menambahkan perilaku ini ke Dispose metode untuk jenis Anda.

Berlaku untuk

Lihat juga