Aracılığıyla paylaş


IMenuCommandService.AddCommand(MenuCommand) Yöntem

Tanım

Belirtilen standart menü komutunu menüye ekler.

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)

Parametreler

command
MenuCommand

MenuCommand Eklenecek.

Özel durumlar

CommandID Belirtilen MenuCommand öğesinin değeri bir menüde zaten var.

Açıklamalar

MenuCommands ve StandardCommands numaralandırmaları, önceden tanımlanmış standart komutlar ve belirli bir menüdeki bir konumla zaten ilişkili menü komutları için tanımlayıcılar içerirCommandID.

Not

Zaten var olan CommandID bir menü komutu ekleme girişimi bir InvalidOperationExceptionoluşturur. Menü komutu eklerken, yöntemini kullanarak zaten bir menüde olmadığından emin olun veya özel durum işlemeyi FindCommand akıllıca kullanın.

Aşağıdaki yordamla önceden tanımlanmış menü komutuna olay işleyicisi ekleyebilirsiniz:

  1. Bir olay işleyicisiyle bağlantı oluşturmak için menü komutu bir menüye eklendiyse veya yöntemiyle FindCommand birlikte bulunuyorsa, bu menü komutunu daha sonra geri yüklemek isteyip istemediğinizi ve yeni olay işleyicinizden geçerli olay işleyicisini çağırmak isteyip istemediğinizi göz önünde bulundurun. Kodunuz menü komutunu geri yükleyebilecek veya olay işleyicilerinin çağrısını zincirleyebileceğinden, menü komutuna yönelik bir başvuruyu bir yerde depolayabileceğinden emin olun.

  2. Önceden var olan ve aynı CommandID olan menü komutlarının yöntemi kullanılarak RemoveCommand menüden kaldırıldığından emin olun.

  3. Yeni MenuCommand bir oluşturun ve oluşturucuda olay işleyicinizi, eklenecek komutu temsil eden bir CommandID ile birlikte belirtin. Her standart menü komutu, eklendiği önceden tanımlanmış bir menü konumuyla ilişkilendirilir. Desteklenen komut kimlikleri ve MenuCommands sabit listelerinde StandardCommands tanımlanır.

  4. Menü komutu için önceden var olan herhangi bir olay işleyicisini çağırmak istiyorsanız, menü komutunuzun çağırma olayını işleyen olay işleyicisinden menüde değiştirdiğiniz menü komutunun yöntemini çağırın Invoke .

  5. Değiştirdiğiniz önceden var olan menü komutunun olay işleyicisini geri yüklemek istiyorsanız, oluşturduğunuz değiştirme menü komutunu kaldırdıktan sonra depolanmış, önceden var olan menü komutunu ekleyin. Bu davranışı türünüz için yöntemine Dispose eklemek isteyebilirsiniz.

Şunlara uygulanır

Ayrıca bkz.