معالج عنصر تحكم ATL

يدرج عنصر تحكم ATL في مشروع ATL (أو مشروع MFC يدعم ATL). يمكنك استخدام هذا المعالج لإدراج أحد ثلاثة أنواع من عناصر التحكم:

• عناصر التحكم القياسية

• عناصر التحكم المركبة

• عناصر تحكم DHTML

بالإضافة إلى ذلك، يمكنك تحديد عنصر تحكم بحد أدنى، مزيلاً بذلك الواجهات من القائمة الواجهات التي يتم توفيرها كافتراضية لعناصر التحكم لتفتح في معظم الحاويات. يمكنك تعيين الواجهات التي تريدها معتمدة لعنصر التحكم في صفحة واجهات من المعالج.

ملاحظات

سيقوم البرنامج النصي للتسجيل الذى تم إنتاجه من قبل هذا المعالج بتسجيل مكونات COM الخاصة به ضمن HKEY_CURRENT_USER بدلاً من HKEY_LOCAL_MACHINE. لتعديل هذا السلوك قم بتعيين خيار تسجيل مكون لكافة المستخدمين من معالج ATL.

الأسماء

تحدد أسماء الكائن و الواجهة و الفئات المراد إضافتها إلى المشروع. فيما عدا الاسم المختصر، يمكن تغيير كافة المربعات الأخري بشكل مستقل. إذا قمت بتغيير النص لـاسم مختصر ينعكس التغيير في أسماء كافة المربعات الأخرى في هذه الصفحة. إذا قمت بتغيير الاسم Coclass في COM مقطع، تغيير هو في المربع النوع ، ولكنها لا تغير الاسم واجهة و معرف البرنامج . تم تصميم سلوك التسمية هذا لجعل كافة الأسماء سهل لك أن تتعرف عليها أثناء تطوير عنصر التحكم الخاص بك.

ملاحظة

coclass قابلة للتحرير على عناصر تحكم ليس لها سمات فقط. إذا كان المشروع له سمات ، لا يمكنك تحرير Coclass.

C++‎

يوفر معلومات لفئة C++ المنشأة لتنفيذ الكائن.

• اسم مختصر
  يعيّن الاسم المختصر للكائن. تحديد الاسم الذي قمت بتوفير فئة و Coclass الأسماء، ملف بأسماء (.CPP و.H) واسم واجهة من نوع تسمية، إلا إذا قمت بتغيير هذه حقول على حدة.

• الفئة
  يعين اسم الفئة التي تطبق الكائن. هذا الاسم يستند علي الاسم الذي توفره في اسم مختصر ، مسبوقاً بـ 'C', البادئة النموذجية لاسم الفئة.

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

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

• ملف .cpp
  يحدد اسم ملف التطبيق لفئة الكائن الجديد. بشكل افتراضي، هذا الاسم يستند علي الاسم الذي توفره في اسم مختصر . انقر فوق الزر (...) لحفظ الملف إلى موقع من اختيارك. لن يتم حفظ الملف إلي الموقع المحدد حتى تقوم بالنقر فوق إنهاء في المعالج.

  المعالج لا يكتب فوق ملف. إذا قمت بتحديد اسم ملف موجود ، عند النقر فوق إنهاء ، المعالج يطالبك بأن تشير إلى ما إذا كان يجب أن يتم إلحاق تطبيق الفئة إلى محتويات الملف. انقر فوق نعم لإلحاق الملف ; انقر فوق لا للرجوع إلى المعالج و تحديد اسم ملف آخر.

• ذو سمات
  يشير إلى ما إذا كان الكائن يستخدم سمات. إذا كنت تقوم بإضافة كائن إلي مشروع ATL ذى سمات ، يكون هذا الخيار محددا و غير متوفر للتغيير. وهذا يعني أنه يمكنك إضافة كائنات ذات سمات فقط إلي مشروع تم إنشاؤه مع دعم السمات.

  يمكنك إضافة كائن ذى سمات فقط إلى مشروع ATL يستخدم سمات. إذا حددت هذا الخيار لمشروع ATL ليس له دعم السمات ، يطالبك المعالج بتحديد ما إذا كنت تريد إضافة دعم السمات إلى المشروع.

  افتراضياً، أي كائنات تقوم بإضافتها بعد تعيين هذا الخيار يتم تعيينها كذات سمات (يتم تحديد خانة الاختيار). يمكنك إلغاء تحديد هذا المربع لإضافة كائن لا يستخدم سمات.

  راجع إعدادات تطبيق معالج مشاريع ATL و الآليات الأساسية للسمات للحصول على مزيد من المعلومات.

COM

يوفر معلومات حول وظيفة COM للكائن.

• coclass
  يحدد اسم فئة المكون التي تحتوي على قائمة واجهات مدعمة من قبل الكائن.

  ملاحظة

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

• الواجهة
  يعين اسم الواجهة للكائن يتم بشكل افتراضي ابتداء اسم الواجهة بـ "I".

• Type
  يعين وصف الكائن الذي سيظهر في التسجيل

• معرف البرنامج
  يحدد الاسم الذي يمكن للحاويات أن تستخدمه بدلاً من CLSID للكائن. في Microsoft Visual C++ 2010, th هو حقل هو تلقائياً تعبئة. إذا لم يمكنك يدوياً ملء هذا الحقل ، عنصر التحكم قد لا يتوفر إلى الأدوات الأخرى. على سبيل المثال، عناصر تحكم ActiveX التي يتم إنشاؤها دون ProgID غير متوفرة في مريع الحوار إدراج عنصر تحكم ActiveX . للحصول على مزيد من المعلومات حول مربع الحوار ، راجع إدراج مربع حوار تحكم ActiveX.

راجع أيضًا:

المهام

إضافة عنصر تحكم ATL

المرجع

أساسيات COM ATL أعضاء البيانات

المبادئ

إضافة وظيفة أعضاء البيانات تحكم مركب