تنفيذ شبكة التنفيذ التلقائي لواجهة مستخدم نمط عنصر التحكم

ملاحظةملاحظة

Th هو الوثائق هو المقصودة لإطار عمل.NET المطورين الذين يرغبون في استخدام المدارة UI Automationالفئات المعرفة في System.Windows.Automationمساحة الاسم.للحصول على أحدث المعلومات حول UI Automation، راجع API التنفيذ التلقائي Windows: أتمتة واجه المستخدم.

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

GridPatternنمط عنصر التحكم هو المستخدمة لدعم عناصر التحكم التي تعمل حاويات لمجموعة من العناصر التابعة. يجب أن يقوم تطبيق توابع هذا العنصر IGridItemProviderو تكون منظمة في النظام إحداثيات منطقية ثنائي الأبعاد يمكن traversed حسب الصف و عمود. للحصول على أمثلة على عناصر التحكم التي تقوم بتنفيذ ذلك نمط عنصر التحكم، راجع نمط عنصر التحكم تعيين عملاء التنفيذ التلقائي لواجهة المستخدم.

يشتمل هذا الموضوع على الأقسام التالية.

  • تطبيق إرشادات و اصطلاحات
  • مطلوب الأعضاء ل IGridProvider
  • Exceptions
  • موضوعات ذات صلة

تطبيق إرشادات و اصطلاحات

عند تنفيذ الشبكة نمط عنصر التحكم، لاحظ الاصطلاحات والإرشادات العامة التالية:

  • شبكة الإحداثيات zero-based مع أعلى اليسار (أو خلية العلوية اليمنى وفقا للإعدادات المحلية) تواجه الإحداثيات (0، 0).

  • إذا كانت إحدى الخلايا هو فارغاً، عنصر "واجهة المستخدم التنفيذ التلقائي" يجب أن لا يزال يتم إرجاع لاعتماد ContainingGridخاصية لتلك الخلية. Th هو هو عند الإمكان تخطيط العناصر التابعة في الشبكة هو مشابهة صفيفة خشنة (انظر المثال أدناه).

مثال الشبكة عنصر تحكم ذات الإحداثيات فارغ

طريقة عرض Windows Explorer توضح تخطيطًا خشنًا.

  • شبكة بعنصر مفرد هو سيظل المطلوبة لتنفيذ IGridProviderإذا هو الاعتبار منطقياً أن الشبكة. عدد عناصر التابعة في شبكة هو immaterial.

  • قد تكون محملة أعمدة، استناداً إلى تطبيق الموفر، وفي UI Automationالشجرة ولذلك تنعكس RowCountو ColumnCountخصائص. إذا كانت صفوف المخفية و لا تحتوي الأعمدة بعد يتم تحميل، يجب أن لا يكون حساب.

  • IGridProviderلا تقوم بتمكين المعالجة النشطة من شبكة;ITransformProviderيجب أن يكون تطبيق إلى تمكين هذه الوظيفة.

  • استخدام StructureChangedEventHandlerللاستماع لتغيير التخطيط أو structural إلى شبكة مثل كـ خلايا التي تم تمت الإضافة، تمت إزالته، أو دمجها.

  • استخدام AutomationFocusChangedEventHandlerإلى تعقب اجتياز عبر عناصر أو خلايا من شبكة.

مطلوب الأعضاء ل IGridProvider

يلي خصائص وأساليب مطلوبة من أجل تطبيق الواجهة IGridProvider.

مطلوب الأعضاء

Type

ملاحظات

RowCount

الخصائص

لا يوجد

ColumnCount

الخصائص

لا يوجد

GetItem

Method

لا يوجد

وهذا نمط عنصر التحكم لديه أية أحداث المقترنة.

Exceptions

يجب أن موفري بطرح استثناء ما يلي.

نوع الاستثناء

Condition

ArgumentOutOfRangeException

GetItem

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

ArgumentOutOfRangeException

GetItem

  • إذا كان المطلوب للصف أو العمود إحداثيات هو أصغر من من الصفر.

راجع أيضًا:

المهام

يعتمد عنصر تحكم نقش في موفر التنفيذ تلقائي واجهة المستخدم

استخدام تخزين مؤقت في واجه المستخدم التنفيذ التلقائي

المبادئ

نظرة عامة حول التنفيذ التلقائي عنصر تحكم نقش واجهة المستخدم

واجهة أتمتة عنصر تحكم نقش للعملاء

تنفيذ GridItem التنفيذ التلقائي لواجهة مستخدم نمط عنصر التحكم

واجه المستخدم أتمتة نظرة عامة على الشجرة