نظرة عامة عن مكوّن Windows Forms) HelpProvider)
يتم استخدام مكوّن نماذج Windows HelpProvider لربط ملف مساعدة HTML مساعدة 1.x (إما ملف بتنسيق .chm, يتم تقديمه بواسطة مساعدات HTML Workshop, أو ملف .htm) مع التطبيق Windows الخاص بك . يمكنك توفير المساعدات بعدة طرق:
توفر مساعدات حساسة-السياق لعناصر التحكم في نماذج Windows.
توفر مساعدات حساسة-السياق في مربع الحوار الخاص أو عناصر تحكم محددة في مربع الحوار.
فتح ملف المساعدة لمناطق معينة, مثل الصفحة الرئيسية من جدول المحتويات, أو الفهرس, أو دالة البحث.
استخدام موفر المساعدة
إضافة مكوّن HelpProvider إلى نموذج Windows يسمح لعناصر التحكم أخرى في النموذج بعرض خصائص تعليمات مكوّن HelpProvider. وهذا يتيح لك تقديم المساعدة لعناصر التحكم الموجودة في نموذج Windows الخاص بك. يمكنك إقران ملف المساعدة مع مكوّن HelpProvider باستخدام خاصية HelpNamespace. تقوم بتعيين نوع المساعدة التي يوفرها استدعاء SetHelpNavigator وتوفر قيمة من قائمة تعداد HelpNavigator لعنصر التحكم المحدد. تقوم بتوفير الكلمة الأساسية أو موضوع المساعدات عن طريق استدعاء أسلوب SetHelpKeyword.
بشكل اختياري، لإقران سلسلة مساعدات محددة في عنصر تحكم آخر, استخدم أسلوب SetHelpString. يتم عرض السلسلة التي قمت بربطها مع عنصر التحكم باستخدام هذا الأسلوب في نافذة منبثقة عندما يقوم المستخدم بالضغط على المفتاح F1 بينما يكون التركيز لعنصر التحكم.
إذا لم يتم تعيين HelpNamespace, يجب عليك استخدام SetHelpString لتوفر نص المساعدة. إذا قمت بتعيين HelpNamespace و سلسلة المساعدة, المساعدة المستنادة إلى HelpNamespace ستكون لها الأسبقية.
ملاحظة
قد تواجه مشكلات في استخدام مسار نسبي عند تعيين المسار ملف المساعدة في أسلوب ShowHelp أو خاصية HelpNamespace الخاصة بعنصر تحكم HelpProvider. على هذا النحو، يجب التأكد من استخدام مسار الملف المطلق لتعيين ملف المساعدة.