كيفية القيام بما يلي: تعريف عنصر مربع أدوات طراز مخصص

لجعل من السهل إنشاء عنصر أو مجموعة من العناصر استناداً إلى نقش تستخدمه غالباً ، يمكنك إضافة أدوات جديدة إلى مربع أدوات مخططات الطراز في Visual Studio Ultimate. يمكن توزيع عناصر مربع الأدوات هذه إلى مستخدمي Visual Studio Ultimate آخرين.

على سبيل المثال، يمكنك جعل أداة مخصصة لإنشاء عناصر مثل هذه:

• حزمة مرتبطة بملف تعريف .NET , و فئة بفئة فرعية لـ .NET.

• زوج من الفئات المرتبطة بواسطة اقتران لتمثيل نقش Observer.

يمكنك استخدام هذه الطريقة لإنشاء أدوات عناصر. أي، يمكنك إنشاء العناصر التي تقوم بسحبها من مربع الأدوات إلى مخطط . لا يمكنك إنشاء أدوات موصّل.

تعريف أداة طراز مخصصة

لتعريف أداة طراز مخصصة

1. أنشئ مخطط UML يحتوي على عنصر أو مجموعة من العناصر.

   • هذه العناصر قد تتوفر علاقات بينها, كما يمكن أن يكون لديها عناصر إضافية مثل المنافذ أو السمات أو العمليات أو الأطراف.

   • في "مستكشف الحلول" , غيّر اسم المخطط للاسم الذي تريد إعطاؤه للأداة الجديدة.

2. احفظ المخطط .

3. باستخدام مستكشف Windows ، انسخ ملفي المخطط إلى المجلد التالي أو أي مجلد فرعي:

   YourDocuments**\Visual Studio 10\Architecture Tools\Custom Toolbox Items**

   • أنشئ هذا المخطط إذا لم يكن موجودًا بالفعل. قد تحتاج لإنشاء كل من Architecture Tools و Custom Toolbox Items.

   • انسخ كلا ملفي المخطط ، أحدهما باسم ينتهي بـ "… diagram" والآخر باسم ينتهي بـ "… diagram.layout"

   • يمكنك صنع العديد من الأدوات المخصصة كما تحب. استخدم مخطط واحد لكل أداة.

4. (اختياري) أنشئ ملف .tbxinfo كما هو موضح في كيفية تعريف الخصائص لأداة مخصصة , و أضفه إلى نفس الدليل. يتيح لك ذلك تعريف أيقونة مربع أدوات ، و تلميح الأدوات ، وهكذا.

   • ملف .tbxinfo وحيد يمكن استخدامه لتعريف العديد من الأدوات. يمكن أن يشير إلى ملفات المخطط الموجودة في المجلدات الفرعية.

5. أعد تشغيل Visual Studio. سوف تظهر الأداة الإضافية في مربع الأدوات للنوع المناسب من المخطط .

ما ستقوم الأداة المخصصة بالنسخ المتماثل له

الأداة المخصصة ستقوم بالنسخ المتماثل لمعظم الميزات للمخطط المصدر:

• الأسماء. عند إنشاء عنصر من مربع الأدوات، يتم إضافة رقم إلى نهاية الاسم إذا لزم الأمر لتجنب أسماء مكررة في نفس مساحة الاسم.

• الألوان و الأحجام و الأشكال

• الفئات الفرعية وملفات تعريف الحزمة

• قيم الخصائص مثل "هو تجريدي" (Is Abstract)

• عناصر العمل المرتبطة

• التعدديات و خصائص أخرى للعلاقات

• المواضع النسبية للأشكال.

لن يتم الاحتفاظ بالميزات التالية في الأداة المخصصة:

• الأشكال البسيطة. هذه هي الأشكال التي لا تتعلق بعناصر الطراز , التي يمكنك رسمها على بعض أنواع المخططات.

• توجيه الموصل. إذا قمت يدوياً بتوجيه الموصلات, لن يتم الاحتفاظ بالتوجيه عند استخدام الأداة الخاصة بك. لا يتم الاحتفاظ المواضع الخاصة ببعض الأشكال المتداخلة، مثل كـ المنافذ، نسبة إلى مالكي المواقع الخاصة بهم.

كيفية تعريف خصائص الأدوات المخصصة

ملف معلومات مربع الأدوات ( .tbxinfo) يسمح لك بتحديد اسم مربع الأدوات و أيقونته و تلميح الأدوات و التبويب و كلمة أساسية للتعليمات لأداة مخصصة واحدة أو أكثر. أعطه أي اسم, مثل MyTools.tbxinfo.

النموذج العام للملف يكون كما يلي:

<?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>

قيمة كل عنصر يمكن أن تكون إما:

• كما هو موضح في المثال, <bmp fileName="…"/> لأيقونة مربع الأدوات و <value>string</value> للعناصر الأخرى.

-أو-

• <resource fileName="Resources.dll"

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

  في هذه الحالة، تقوم أنت بتوفير التجميع المحول برمجيا الذي فيه يتم التحويل البرمجي لقيم السلسلة كمصادر.

أضف عقدة <customToolboxItem> لكل عنصر مربع أدوات تريد تعريفه.

العقد في ملف .tbxinfo تكون كما يلي. توجد قيمة افتراضية لكل عقدة.

اسم العقدة	يعرّف
displayName	اسم عنصر مربع الأدوات.
tabName	علامة تبويب مربع الأدوات التي يظهر فيها العنصر. يمكنك تحديد إما اسم علامة التبويب العادية لهذا النوع من المخطط , أو اسم منفصل .
صورة	موقع ملف الصورة النقطية ( .bmp) ، الذي يجب أن يكون ارتفاعه و عرصه 16 , و عمق الألوان "24 بت".
f1Keyword	الكلمة الأساسية التي تحدد موقع موضوع التعليمات.
تعريف الأداة	تلميح الأداة لهذه الأداة.

يمكنك تحرير ملف الصورة النقطية في Visual Studio ، و تعيين الارتفاع والعرض إلى 16 في النافذة "خصائص".

ملاحظة

في حالة البدء في استخدام ملف .tbxinfo بعد تجربة استخدام ملفات المخطط بمفردها, قد تجد أن مربع الأدوات يحتوي على كل من الإصدارات القديمة و الجديدة من عنصر مربع الأدوات. يمكن أيضاً أن يحدث هذا إذا تمت كتابة اسم المخطط في ملف .tbxinfo بشكل خاطئ. في حالة حدوث ذلك، انقر يمينا فوق عنصر مربع أدوات ثم انقر فوق إعادة تعيين مربع الأدوات. سوف تختفي عناصر مربع الأدوات المخصصة. أعادة تشغيل Visual Studio ، و سوف تظهر العناصر المخصصة الصحيحة.

كيفية توزيع عناصر مربع الأدوات في ملحق Visual Studio

يمكنك توزيع عناصر مربع الأدوات إلى مستخدمي Visual Studio  الأخرين بواسطة حَزمها في ملحق Visual Studio (VSIX). يمكنك حَزم أوامر وملفات تعريف و ملحقات أخرى في نفس ملف VSIX. لمزيد من المعلومات، راجع نشر ملحقات Visual Studio.

الطريقة المعتادة لإنشاء ملحق Visual Studio هي استخدام قالب مشروع VSIX. للقيام بذلك، يجب أن تكون قد قمت بتثبيت عدة تطوير البرامج لـ Visual Studio.

لإضافة عنصر مربع أدوات إلى ملحق Visual Studio

1. إنشاء و اختبار واحد أو أكثر من الأدوات المخصص.

2. أنشئ ملف .tbxinfo يشير إلى الأدوات.

3. افتح مشروع ملحق Visual Studio موجود .

   -أو-

   عرّف مشروع ملحق Visual Studio جديد .

   1. من القائمة File (ملف)، أشر إلى New (جديد)، ثم انقر فوق Project (مشروع).

   2. في مربع حوار مشروع جديد , ضِمن القوالب المثبتة، قم بتوسيع Visual C#‎ ، انقر فوق القابلية للتوسعةو ثم انقر فوق مشروع VSIX. عيّن اسم المشروع و انقر فوق موافق .

4. أضف تعريفات مربع الأدوات الخاصة بك إلى المشروع. ضمّن الملف .tbxinfo , و ملفات المخطط , و ملفات الصور النقطية , و أي ملفات مورد , وتأكد من أنه تم تضمينها في VSIX.

   • في "مستكشف الحلول", انقر يمينا فوق المشروع، أشر إلى إضافة، ثم انقر فوق عنصر موجود. في مربع الحوار ، عيّن "كائنات من نوع": All Files. بحث ملفات حدد جميعا وثم انقر فوق إضافة.

     ملاحظة

     في هذا المشروع , لا يمكنك فتح ملفات المخطط في محرر الطراز.

5. عيّن الخصائص التالية لكافة الملفات التي قمت بإضافتها تواً. يمكنك تعيين الخصائص الخاصة بهم في نفس الوقت بواسطة تحديدها في "مستكشف الحلول". كن حذراً لا إلى تغيير خصائص الملفات الأخرى في مشروع.

   النسخ إلى دليل الإخراج = نسخ دوماً

   إجراء البناء = المحتوى

   تضمين في VSIX = true

6. قم بفتح source.extension.vsixmanifest. يتم فتحه في محرر ملف بيان الملحق.

7. تحت محتوى ، أضف صفًا يصف الأدوات المخصصة. انقر فوق إضافة محتوى ، ثم قم بتعيين الحقول في مربع الحوار كما يلي:

   • نوع المحتوى = نوع ملحق مخصص

   • النوع =Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems

   • المسار = ملف في المشروع . حدد ملف .tbxinfo الخاص بك ، على سبيل المثالMyTools.tbxinfo

8. يمكنك تعيين اسم المنتَج و الحقول كما تريد.

9. إنشاء المشروع.

10. في مستكشف Windows، افتح المجلد . \bin\Debug or . \bin\Release to find the .vsix file. هذا هو ملف ملحق Visual Studio . يمكن تثبيته على جهاز الكمبيوتر الخاص بك و إرساله لمستخدمي Visual Studio الآخرين.

لتثبيت أدوات مخصصة من ملحق Visual Studio

1. انقر نقراً مزدوجاً فوق الملف .vsix في مستكشف Windows , أو افتحه داخل Visual Studio.

2. في مربع الحوار الذي يظهر أمامك، انقر فوق تثبيت.

3. لإلغاء تثبيت أو تعطيل الملحق مؤقتًا, افتح مدير الملحقات من قائمة أدوات .

ترجمة

يمكنك صنع الملحق الذي -عند تثبيته على جهاز كمبيوتر آخر- يعرض أسماء و تلميحات الأدوات بلغة الكمبيوتر الهدف.

لتوفير إصدارات من الأداة بأكثر من لغة

1. أنشئ مشروع ملحق Visual Studio يحتوي على أداة مخصصة أو أكثر.

   في الملف .tbxinfo , استخدم أسلوب ملف المورد لتعريف displayName للأداة، و tabName لمربع الأدوات، و تلميح الأداة. أنشئ ملف مورد يتم فيه تعريف هذه السلاسل, ثم حوّله برمجيا لتجميع , ثم أشر إليه من الملف tbxinfo.

2. قم بإنشاء تجميعات الإضافية التي تحتوي على ملفات موارد تحتوي على سلاسل بلغات غير ذلك.

3. ضع كل تجميع إضافي في مجلد اسمه هو رمز البيانات الموروثة للغة. على سبيل المثال، قم بوضع الإصدار اللغة فرنسية من تجميع داخل مجلد يسمى fr.

4. يجب عليك استخدام رمز ثقافة محايد, عادةً اثنين من الأحرف, و ليس ثقافة معينة مثل fr-CA. لمزيد من المعلومات حول رموز البيانات الموروثة راجع أسلوب CultureInfo.GetCultures ، الذي يوفر قائمة كاملة من رموز البيانات الموروثة.

5. أنشئ ملحق Studio Visual , ثم قم بتوزيعه.

6. عند تثبيت الملحق على كمبيوتر آخر , إصدار ملف المورد بالنسبة للبيانات الموروثة الخاصة بالمستخدم سيتم تلقائياً تحميله. إذا لم يتم توفير إصدار لثقافة المستخدم ، سيتم استخدام الموارد الافتراضية.

لا يمكنك استخدام هذا الأسلوب لتثبيت إصدارات مختلفة من النموذج الأولي للمخطط . أسماء العناصر و الموصلات ستكون كما هي في كل تثبيت.

عمليات مربع الأدوات الأخرى

عادةً, في Visual Studio ، يمكنك تخصيص مربع الأدوات عن طريق إعادة تسمية الأدوات, و نقلها إلى علامات التبويب مختلفة, و حذفها. ولكن هذه التغييرات لا تستمر لأدوات التصميم المخصصة المنشأة من الإجراءات الموضحة في هذا الموضوع. عند إعادة تشغيل Visual Studio ، تظهر الأدوات المخصصة بالأسماء و مواقع مربع الأدوات المعرّفة.

علاوة على ذلك، سوف تختفي الأدوات المخصصة الخاصة بك إذا كنت تنفّذ الأمر إعادة تعيين مربع الأدوات. ومع ذلك، فإنها ستظهر عند إعادة تشغيل Visual Studio.

راجع أيضًا:

المبادئ

كيفية القيام بما يلي: تعريف ملف تعريف لتوسيع UML

موارد أخرى

طرازات متوسعه و مخططات

كيفية القيام بما يلي: تعريف أمر قائمة على مخطط طراز

كيفية القيام بما يلي: تعريف قيود التحقق من صحة طرازات UML