Windows Formları için Tasarımcı Komutları ve DesignerAction Nesne Modeli

Makale
06/09/2015

Tasarımcı komutları ve DesignerAction nesne modeli tasarım zamanında bir bileşen için Eylemler kümesini belirtmek Genelleştirilmiş bir yol sağlar.Kullanıcılar daha sonra erişim bu eylemleri tasarımı yüzeyinden genellikle bir bileşenin akıllı etiket glifi tıklatarak ( Akıllı etiket karakteri ) ve akıllı etiket panelinden önerilen eylemlerden birini seçerek.Bu model bir tasarımcı komutları kullanıcılara sunmak çeşitli şekillerde birleştirir.

Akıllı Etiketler

Bileşenleri ve denetimleri kullanıcılar için bağlam duyarlı bilgiler ve komutları görüntülemek için akıllı etiket özelliği sağlar.Akıllı Etiket Madde akıllı etiket panelinde ve ayrıca bir bileşeni veya denetimi ile ilişkili kısayol menüsünü görüntülemek seçebilirsiniz çünkü akıllı etiket, tasarımcı fiiller yerini olarak düşünülebilir.

Akıllı etiketler nasıl uygulayabilirsiniz tam örnek için bkz: Nasıl yapılır: Windows Formları Bileşenine Akıllı Etiket Ekleme.

Tasarımcı komut sınıfları

Aşağıdaki tabloda, bileşenleri ve denetimleri geliştirirken Tasarımcı komutları için açık olan yolları anlatılmaktadır.

Sınıf	Description
MenuCommand	Komut Kimliği için bağlı bir temsilciKomut metni, yerleşimi ve diğer meta veri tanımlamaz.
DesignerVerb	Ayrıca, metin ve diğer meta verileri tanımlayan menü komutu.Fiiller Tasarımcısı başına temelinde genellikle sunulan ve tasarımcıya özgüdür.Tasarımcı fiiller kısayol menüsündeki veya genellikle gösterilir View ana menü çubuğunun menü.
DesignerActionItem	Metin ve gerçekleştirilebilir hedeflenen bir eylem tanımlamak için diğer meta verileri tanımlayan menü komutu.Eylemler genelde kullanıcı bir bileşen için bir veri kaynağı yapılandırma gibi bazı multi-step süreci boyunca Yürüyüş.

İtme ve çekme modelleri

Tasarımcı komutları program aracılığıyla erişmek için iki model aşağıdaki tabloda gösterilmiştir.

Model	Description
İtme	Bir tasarımcı, özellikle servis talebinde ve bu hizmet için komutlar ekler.
Tanıtım	Bir tasarımcı, bir hizmet sunduğu komutları için sorgulanır.

Varolan birleştirme komutları

Var. çok ortak Tasarımcı komut sınıflar yukarıdaki tabloda listelenen komutları türleri arasında.DesignerAction API komutları bir tasarımcı kullanıcılara sunduğu için tekdüzen bir modeli birlikte sunmak için bu duruma getirir.

[!NOT]

Tüm tasarımcıları tüm modelleri destekler.Bir tasarımcı desteği ne tür sunulan sorgulayabilir ve yanıt olarak onu nasıl komutları sunar değişebilir.Buna ek olarak, itme ve çekme modelleri komutları her tür desteklenmiyor olabilir.Tüm tasarımcılar Tasarımcı eylemleri Akıllı etiketler geçirecek.Örneğin, bazı tasarımcıları Tasarımcı Eylemler araç penceresinde getirebilir.

DesignerAction nesne modeli

DesignerAction nesne modelini uygulayan önemli sınıflar aşağıdaki tabloda açıklanmaktadır.

Sınıf	Description
DesignerActionItem	Akıllı etiket panelinde Masası öğesini temsil eder.
DesignerActionList	Akıllı etiket paneli oluşturmak için kullanılan öğeler listesini tanımlar.
DesignerActionService	Topluluğu yöneten bir tasarım zamanı hizmet kurar DesignerActionItem bileşenleri için nesneler.
DesignerActionTextItem	Bir panel üzerinde bir statik metin öğesini temsil eder.Türetildiği DesignerActionItem.
DesignerActionPropertyItem	Türetilen bir sınıfı bir özelliği ile ilişkili bir Masası öğesini temsil eden DesignerActionList.Türetildiği DesignerActionItem.
DesignerActionMethodItem	Türetilen bir sınıfı bir yöntemi ile ilişkili bir Masası öğesini temsil eden DesignerActionList.Türetildiği DesignerActionItem.
DesignerActionHeaderItem	Statik üstbilgi öğesi bir akıllı etiket panelinde temsil eder.Türetildiği DesignerActionTextItem.

DesignerAction nesne modelini kullanarak

Öğesinden türetilmeli bileşeni veya denetimi için tasarımcı eylemleri etkinleştirmek için DesignerActionList taban sınıfı.Türetilmiş bir sınıf bu menü benzeri UI gösteren bir akıllı etiket panel doldurmak için kullanın.

Geçersiz kılabilir, türetilmiş bir sınıf virtualGetSortedActionItems yöntemi nesneler topluluğu geri dönmek için türetilmiş DesignerActionItem.Bu nesneler Masası öğelerini temsil eder.Her öğenin kendi tipine göre panelinde görüntülenir.Örneğin, bir DesignerActionTextItem statik metin etiket olarak görüntülenir.Etkin Masası öğelerini, tarafından temsil edilen DesignerActionPropertyItem ve DesignerActionMethodItem türleri, sahip bir karşılık gelen genel olarak erişilebilen özellik veya yöntem, sırasıyla, bu maddenin işlevselliğini uygulayan.

Türetilmiş bir sınıf, oluşturulduktan sonra bir denetime iki yolla ekleyebilirsiniz:

Tanıtım modeli ile türetilmiş bir sınıf örneğini eklemek ActionLists özelliği ComponentDesigner sınıfı.Diğer eylem listesi sağlamak için sınıflar devralırken ve öğelerinin birleştirilmesi için bir yol sağlar.
İtmeli çoğaltma modeli ile çağrı Add , türetilmiş bir sınıf örneği genel tarafından tutulan koleksiyona eklemek için DesignerActionService.Bu eylem listeler olanlar tarafından tutulan koleksiyonu ile birleştirilmiş ComponentDesigner.

A DesignerActionPropertyItem , ilgili Tasarımcısı'nda temsil UITypeEditor.A DesignerActionMethodItem Tasarımcısı'nda Programcı tarafından sağlanan yöntemini çağıran bir köprü gibi etkin bir UI öğe ile temsil edilir.Eylem listenizin uygulaması GetSortedActionItems yöntemi bunların görüntülenmesi gereken akıllı etiket panelinde sırada döndürür özellikleri ve yöntemleri.

Akıllı etiketleri uygulamak tam örnek için konusuna Nasıl yapılır: Windows Formları Bileşenine Akıllı Etiket Ekleme.

Eylem listelerinde varolan fiiller

Denetimler ve temeli bileşenleri DesignerVerb uygulamaları otomatik olarak almak DesignerActionList destekler.Eylem listesi için bir bileşenin Tasarımcısı tasarım ortamını sorgular ve hiçbiri kullanılabilir durumdaysa, bir varolan fiiller için oluşturulur.

Kısayol menüsünde eylem liste öğeleri

Öğenin kısayol menüsünü ve eylem listesinde görünmesini isterseniz, belirtebileceğiniz IncludeAsDesignerVerb üzerinde bayrak DesignerActionMethodItem.

Zaman Add olarak adlandırılan, eylem listesi için taranmış DesignerActionMethodItem ile IncludeAsDesignerVerb bayrağı ayarlanmışsa.Ayarlı ise, AddVerb yönteminin çağrıldığı, bileşenin fiiller eklemek bu maddenin ve bu yüzden, kısayol menüsü.

Designer komut türlerini yapılan değişiklikler

MenuCommand Ve DesignerVerb gelen sınıfları.net Framework sürüm 1.1 biraz değişmiştir DesignerAction nesne modeli desteklemek için.Her iki tür şimdi adlı yeni bir özellik açığa Properties, olduğu bir IDictionary , command nesnesi için tüm ortak özelliklerini saklar.Ortak özelliğin adı sözlük anahtarıdır.Bu özelliklerin Genel numaralandırmasını etkinleştirir ve yeni özellikler, eklenebilir sınıf tanımının değiştirmeden tutarlı bir temel sağlar.

Buna ek olarak, MenuCommandService SAX, standart bir uygulama IMenuCommandService ve doğru fiil entegrasyonu gerçekleştirir.Bu sınıf ekleme ve çıkarma komutları olayları uyarma yükseltir.Bu sınıf ile bu olayların sonuçlarına dayalı bir kullanıcı Arabirimi oluşturabilirsiniz.MenuCommandService, yanı IMenuCommandService, hizmet kapsayıcısında bulunur.

Ayrıca bkz.