Nasıl yapılır: Özel Modelleme Araç Kutusu Öğesi Tanımlama

Makale
06/10/2015

Sık kullandığınız bir desene göre bir öğe veya öğe grupları oluşturmayı kolaylaştırmak için, yeni araçları Visual Studio Ultimate'daki modelleme diyagramları araç kutusuna ekleyebilirsiniz.Bu araç kutusu öğelerini diğer Visual Studio Ultimate kullanıcılarına dağıtabilirsiniz.

Özel bir araç bir diyagramında bir veya daha fazla yeni öğeler oluşturur.Özel bağlantı araçları oluşturamazsınız.

Örneğin, bunlar gibi öğeleri oluşturmak için özel araç yapabilirsiniz:

.NET profiline bağlı bir paket ve .NET stereotipi ile bir sınıf.
Gözlemci desenini göstermek için bir ilişkilendirme tarafından bağlantılı sınıflar çifti.

Öğe araçları oluşturmak için bu yöntemi kullanabilirsiniz.Yani, araç kutusundan bir diyagram üzerine sürüklediğiniz araçlar oluşturabilirsiniz.Bağlayıcı araçları oluşturamazsınız.

Özel Modelleme Aracı Tanımlama

Özel modelleme aracı tanımlamak için

Öğe veya öğe grupları içeren bir UML diyagram oluşturun.
- Bu öğelerin onlar arasında ilişkileri ve bağlantı noktaları, öznitelikler, işlemler veya sabitleyiciler gibi bağlı öğeleri olabilir.
Yeni araca vermek istediğiniz adı kullanarak diyagramı kaydedin.Üzerinde Dosya menüsünde, kullanım Kaydet...As.
Windows Gezgini'ni kullanarak, iki diyagram dosyasını aşağıdaki klasör veya herhangi bir alt klasöre kopyalayın:

YourDocuments**\Visual Studio 2012\Architecture Tools\Custom Toolbox Items**
- Bu klasörü zaten yoksa oluşturun.Hem Architecture Tools hem de Custom Toolbox Items oluşturmanız gerekebilir.
- Her iki diyagram dosyasını da kopyalayın, birinin ismi "…diagram" ile ve diğerinin ismi "…diagram.layout" ile biter.
- İstediğiniz kadar fazla özel araç yapabilirsiniz.Her araç için bir diyagram kullanın.
(İsteğe bağlı) Özel Araç Özellikleri Nasıl Tanımlanır'da tanımlandığı gibi .tbxinfo dosyası oluşturun ve onu aynı dizine ekleyin.Bu; araç kutusu simgesi, araç ipucu ve benzerlerini tanımlamanıza olanak sağlar.
- Tek bir .tbxinfo dosyası çeşitli araçları tanımlamak için kullanılabilir.Bu dosya, alt klasörlerdeki diyagram dosyalarına başvurabilir.
Visual Studio'yu yeniden başlatın.Ek araç, uygun diyagram türü için araç kutusunda görüntülenecektir.

Özel Araç Ne Çoğaltır

Bir özel araç kaynak diyagramın çoğu özelliğini çoğaltacaktır:

Adlar.Araç kutusundan bir öğe oluşturulduğu zaman, aynı isim uzayı içinde yinelenen isim olmasından kaçınmak gerekliyse ismin sonuna bir sayı eklenir.
Renkler, boyutlar ve şekiller
Stereotipler ve paket profilleri
Is Abstract (Soyut mu) gibi özellik değerleri
Bağlantılı iş öğeleri
Çeşitlilikler ve ilişkilerin diğer özellikleri
Şekillerin göreli konumları.

Aşağıdaki özellikler özel araç içinde korunmayacaktır:

Basit şekiller.Bunlar; model öğeleri ile ilgisi olmayan, diyagramların bazı türleri üzerine çizebileceğiniz şekillerdir.
Bağlayıcı yönlendirme.Eğer bağlayıcıları el ile yönlendirirseniz yönlendirme, aracınız kullanıldığında korunmayacaktır.Bağlantı Noktaları gibi iç içe şekillerin konumları onların sahiplerine göreli olarak korunmaz.

Özel Araçların Özellikleri Nasıl Tanımlanır

Bir araç kutusu bilgi (.tbxinfo) dosyası; bir veya daha çok özel araç için bir araç kutusu adı, simge, araç ipucu, sekme ve yardım anahtar sözcüklerini belirtmenize olanak sağlar.MyTools.tbxinfo gibi herhangi bir isim verin.

Dosyanın genel biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8" ?>
<customToolboxItems xmlns="https://schemas.microsoft.com/visualstudio/2010/ArchitectureTools/CustomToolboxItems">
  <customToolboxItem fileName="MyObserverTool.classdiagram">
    <displayName>
       <value>Observer Pattern</value>
    </displayName>
    <tabName>
       <value>UML Class Diagram</value>
    </tabName>
    <image><bmp fileName="ObserverPatternIcon.bmp"/></image>
    <f1Keyword>
      <value>ObserverPatternHelp</value>
    </f1Keyword>
    <tooltip>
       <value>Create a pair of classes</value>
    </tooltip>
  </customToolboxItem>
</customToolboxItems>

Her öğenin değeri bu olabilir:

Örnekte gösterildiği gibi, araç kutusu simgesi için <bmp fileName="…"/> ve diğer öğeler için <value>string</value>.

- veya -

<resource fileName="Resources.dll"

baseName="Observer.resources" id="Observer.tabname" />

Bu durumda, dize değerlerinin kaynaklar olarak derlendiği derlenmiş bütünleştirilmiş bir kod sağlayın.

Tanımlamak istediğiniz her araç kutusu öğesi için <customToolboxItem> düğümü ekleyin.

.tbxinfo dosyasındaki düğümler aşağıdaki gibidir.Her düğüm için varsayılan bir değer vardır.

Düğüm adı	Tanımlar
displayName	Araç kutusu öğesinin adı.
tabName	Öğenin görüntülenmesi gereken araç kutusu sekmesi.Bu tür bir diyagram için ya normal sekmenin adını ya da ayrı bir ad belirtebilirsiniz.
image	Yüksekliği ve genişliği 16 ve renk derinliği 24 bit olması gereken bit eşlem (.bmp) dosyasının konumu.
f1Keyword	Yardım konusunu bulan anahtar sözcük.
tooltip	Bu arac için araç ipucu.

Visual Studio'da bit eşlem dosyasını düzenleyebilirsiniz ve Özellikler penceresinde yükseklik ve genişliği 16'ya ayarlayabilirsiniz.

[!NOT]

Eğer diyagram dosyalarını kendi başlarına kullanmayı denedikten sonra .tbxinfo dosyasını kullanmaya başlarsanız; araç kutusunun, bir araç kutusu öğesinin hem eski hem de yeni sürümlerini içerdiğini bulabilirsiniz.Bu, eğer diyagram dosyasının adı .tbxinfo dosyasında yanlış yazılmışsa da oluşabilir.Bu durumda, araç kutusu kısayol menüsünden seçin Reset Toolbox.Özel araç öğeleri kaybolacaktır.Visual Studio'yu yeniden başlatın ve doğru özel öğeler görünecektir.

Visual Studio Uzantısı'nda Araç Kutusu Öğeleri Nasıl Dağıtılır

Araç kutusu öğelerini, diğer Visual Studio kullanıcılarına onları Visual Studio Uzantısı (VSIX) içinde paketleyerek dağıtabilirsiniz.Komutları, profilleri ve diğer uzantıları aynı VSIX dosyasında paketleyebilirsiniz. Daha fazla bilgi için bkz. Visual Studio Uzantılarını Dağıtma.

Bir Visual Studio uzantısı derlemenin her zamanki yolu VSIX proje şablonu kullanmaktır.Bunu yapmak için, Visual Studio SDK yüklü olmalıdır.

Visual Studio uzantısına bir Araç Kutusu Öğesi eklemek için

Bir veya daha fazla özel araç oluşturun ve sınayın.
Araçlara başvuran .tbxinfo dosyası oluşturun.
Varolan bir Visual Studio uzantı projesi açın.

- veya -

Yeni bir Visual Studio uzantı projesi tanımlayın.
1. Üzerinde Dosya menüsünden seçin Yeni, Proje.
2. İçinde Yeni Proje iletişim kutusunda, altında Yüklü Şablonlar, seçim Visual C#, genişletilebilirlik, VSIX proje.
Araç kutusu tanımlarınızı projeye ekleyin..tbxinfo dosyasını, diyagram dosyalarını, bit eşlem dosyalarını ve herhangi bir kaynak dosyasını dahil edin ve onların VSIX içine dahil olduğundan emin olun.
- Çözüm Gezgini'nde VSIX projesine kısayol menüsünden seçin Ekle, Varolan madde.İletişim kutusunda Tür Nesneleri: Tüm Dosyalar öğesini ayarlayın.Dosyaları bulun, tümünü seçin ve sonra seçin Ekle.
  
  [!NOT]
  
  Bu projede, model düzenleyicisinde diyagram dosyaları açamazsınız.
Henüz eklemiş olduğunuz aşağıdaki tüm dosya özelliklerini ayarlayın.Çözüm Gezgini'nde tümünü seçerek onların özelliklerini aynı anda ayarlayabilirsiniz.Projedeki düğer dosyaların özelliklerinin değişmemesine dikkat edin.

Çıktı Dizinine Kopyala = Her zaman kopyala

Derleme Eylemi = İçerik

Include in VSIX (VSIX'e dahil et) = true (doğru)
source.extension.vsixmanifest öğesini açın.Uzantı bildirim düzenleyicisinde açılır.
Altında meta veri, özel araçlar için bir açıklama ekleyin.

Altında varlıklarını, seçim Yeni ve alanları iletişim kutusunda aşağıdaki gibi ayarlayın:
- Türü = Özel uzantı türü
- Tür = Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems.
  
  [!NOT]
  
  Bu aşağı açılan listesindeki seçeneklerden biri değil.Klavyeyi kullanarak girmek zorunda.
- Kaynak = Dosya sistemi dosya.
- Yol =, .tbxinfo , örneğin dosyaMyTools.tbxinfo
Projeyi yapılandırın.
Uzantı çalıştığını doğrulamak için, F5 tuşuna basın.Visual Studio'nun deneysel örneği başlar.

Deneysel örneği oluşturabilir veya ilgili türde bir uml diyagramı açın.Yeni araç araç kutusunda görüntülenir ve bu öğeleri doğru oluşturur doğrulayın.
Bir VSIX dosyası dağıtımı için elde etmek için: klasörü Windows Gezgini'nde açın .\bin\Debug veya .\bin\Release bulmak için .vsix dosyası.Bu Visual Studio Uzantı dosyasıdır.Bilgisayarınıza yüklenebilir ve diğer Visual Studio kullanıcılarına gönderilebilir.

Visual Studio Uzantılarından özel araçları yüklemek için

Açık .vsix dosyasını Windows Gezgini'nde ya da Visual Studio.
Seçim Yükleme iletişim kutusunda görünür.
Uzantıyı kaldırmak veya geçici olarak devre dışı bırakmak için Araçlar menüsünden Uzantı Yöneticisi'ni açın.

Yerelleştirme

Başka bir bilgisayar üzerinde yüklü olduğunda, hedef bilgisayar dilinde araç adlarını ve araç ipuçlarını gösterecek bir uzantı yapabilirsiniz.

Birden çok dilde araç sürümlerini sağlamak için

Bir veya daha fazla özel araç içeren Visual Studio Uzantı projesi oluşturun.

.tbxinfo dosyasında, aracın displayName, toolbox,tabName ve tooltip'ini tanımlamak için kaynak dosya yöntemini kullanın.Bu dizgilerin tanımlandığı bir kaynak dosyası oluşturun, bütünleştirilmiş kod içine derleyin ve tbxinfo dosyasından başvurun.
Kaynak dosyalarını diğer dillerdeki dizgilerle birlikte içeren ek derlemeler oluşturun.
Her ek derlemeyi dil için adı kültür kodu olan bir klasöre yerleştirin.Örneğin, derlemenin Fransızca sürümünü fr olarak adlandırılmış dosyanın içine yerleştirin.
fr-CA gibi belirli bir kültür kodu değil genellikle iki harf, bağımsız kültür kodu kullanmalısınız.Kültür kodları hakkında daha fazla bilgi için, kültür kodlarının tam listesini sağlayan CultureInfo.GetCultures yöntemi bağlantısına bakın.
Visual Studio Uzantısı'nı yapılandırın ve dağıtın.
Uzantı başka bir bilgisayara yüklendiğinde, kullanıcının yerel kültürü için olan kaynak dosyasının sürümü otomatik olarak yüklenecektir.Eğer kullanıcının kültürü için bir sürüm sağlamamışsanız, varsayılan kaynaklar kullanılacaktır.

Bu yöntemi prototip diyagramın farklı sürümlerini yüklemek için kullanamazsınız.Öğelerin ve bağlayıcıların adları her yüklemede aynı olacaktır.

Diğer Araç Kutusu İşlemleri

Normalde, Visual Studio, araç kutusunu araçları yeniden adlandırarak, onları farklı araç kutusu sekmelerine taşıyarak ve onları silerek kişiselleştirebilirsiniz. Ancak, bu konuda açıklanan yordamları ile oluşturulmuş özel modelleme araçları için bu değişiklikler geçerli olmaz.Visual Studio'yu yeniden başlattığınızda, özel araçlar tanımlanmış adları ve araç kutusu konumları ile yeniden görünecektir.

Ayrıca, eğer Reset Toolbox (Araç Kutusunu Sıfırla) komutunu uygularsanız özel araçlarınız kaybolacaktır.Ancak, Visual Studio'yu yeniden başlattığınızda yine görünecektir.