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

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

نظرة عامة حول هذا يصف كيفية استخدام Microsoft UI Automationلعرض محتوى نصي، بما فيها السمات التنسيق والأنماط، للنص عناصر التحكم في UI Automation-اعتماد الأنظمة الأساسية. These controls include, but are not limited to, the Microsoft NET Framewor. TextBox and RichTextBox as well as their Win32 equivalents.

Exposing the textual content of a control is accomplished through the use of the TextPattern control pattern, which represents the contents of a text container as a text stream. في تشغيل، TextPatternيتطلب الدعم من TextPatternRangeالفئة إلى تعريض التنسيق والأنماط السمات. TextPatternRangeيعتمدTextPatternبتمثل متجاورة أو متعددة، منفصلتين يمتد نص في حاوية نص باستخدام مجموعة منStartوEndنقاط النهاية. TextPatternRangeتدعم وظائف مثل كـ تحديد والمقارنة، استرداد واجتياز.

ملاحظة
TextPatternفئات لا توفر وسيلة إلى إدراج أو تعديل نص.However, depending on the control, this may be accomplished by the UI Automation ValuePattern or through direct keyboard input.انظر في إدراج ValuePattern أعضاء البيانات نموذجلعلى سبيل المثال.

الوظيفة التي تم وصفها في ترتيب هو نظرة عامة حول هو الهامة لموردي التكنولوجيا assهوtive والمستخدمين النهائيين الخاصة بهم. يمكن استخدام تقنيات مساعدة UI Automationإلى جمع النص الكامل لتنسيق المعلومات للمستخدم وتوفير البرمجي التنقل وتحديد نص بواسطة TextUnit(حرف, wأوd, خط, أو فقرة).

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

• أو TextPattern التنفيذ التلقائي لواجهة المستخدم.نص الالخدمات إطار عمل
• عنصر تحكم أنواع
• عميل TextPattern لواجهة برمجة تطبيقات
• موفر TextPattern لواجهة برمجة تطبيقات
• الأمان
• الأداء
• مصطلحات TextPattern
• موضوعات ذات صلة

أو TextPattern التنفيذ التلقائي لواجهة المستخدم.نص الالخدمات إطار عمل

إطار خدمات النصوص (TSF)هو إطار عمل النظام بسيطة وقابلة للتحجيم من الخدمات اللغة الطبيعية والنصوص المتقدمة إدخال تشغيل سطح المكتب وفي التطبيقات. في بالإضافة إلى providفيg في terfaces للتطبيقات لعرض نص به تخزينها أيضا بيانات تعريف يدعم ذلك لتخزين نص.

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

باختصار، يمكن الوصول إلى التقنيات التي تتطلب وصول القراءة فقط إلى مخزن نص باستخدام TextPattern، ولكنك بحاجة لوظيفة أكثر تعقيداً TSFللإدخال على علم بالسياق.

عنصر تحكم أنواع

Text

النص عنصر تحكم هو العنصر الأساسي الذي يمثل جزء من النص تشغيل شاشة.

يمكن استخدام عنصر تحكم نص مستقل التسمية أو نص ثابت في نموذج. نص عناصر التحكم يكون موجوداً داخل بنية على ListItem، TreeItemأو DataItem.

ملاحظة

نص عناصر التحكم قد لا تظهر في طريقة عرض المحتوى UI Automationالشجرة (راجع واجه المستخدم أتمتة نظرة عامة على الشجرة).Th هو هو لأن عناصر النص غالباً ما تكون dهوplayed من خلال خاصية اسم لعنصر تحكم آخر.على سبيل المثال، نص الذي هو تستخدم لتسمية عنصر تحكم تحرير هو كشف من خلال خاصية اسم عنصر التحكم تحرير.لأنه يتم تحرير عنصر التحكم في طريقة عرض المحتوى UI Automationشجرة، فإنه ليس من الضروري لعنصر نص نفسه إلى في طريقة العرض هذه من UI Automationشجرة.نص الوحيد الذي يظهر في عرض "المحتوى" هو نص غير معلومات متكررة.بما يمكن من أي التقنية مساعدة إلى بسرعة تصفية تشغيل أجزاء المعلومات التي يحتاج إليها المستخدمون الخاصة بهم فقط.

تحرير

عناصر تحكم التحرير تمكن المستخدمين من عرض وتحرير سطر نص واحد.

ملاحظة
قد التفاف سطر مفرد من نص في بعض السيناريوهات التخطيط.

مستند

تتيح عناصر التحكم بالمستند مستخدم التنقل والحصول على معلومات من الصفحات متعددة من نص.

عميل TextPattern لواجهة برمجة تطبيقات

System.Windows.Automation.TextPattern Class	يؤشر إدخال ل Microsoft UI Automationنموذج نص. هذه الفئة أيضا على جهازي TextPatternرسائل حدث، TextSelectionChangedEventو TextChangedEvent.
System.Windows.Automation.Text.TextPatternRange Class	تمثيل تجاوز من النص داخل حاوية نص يعتمد TextPattern. عملاء واجه المستخدم التنفيذ التلقائي يجب أن تكون حريصا على صلاحية الحالي نطاق نص التي تم إنشاؤها باستخدام TextPatternRange. إذا كان التحكم بالنص الأصلي في النص هو يصبح تماما يستبدل بنص جديد، نطاق النص الحالي هو غير صالح. ومع ذلك، نطاق نص قد استمرت بعض viability إذا كان جزءا فقط من نص الأصلي هو تم تغييرهها والتحكم في نص الأساسي هو إدارة نصه "المؤشر" مع نقاط ارتساء (أو نقاط النهاية) بدلاً من أن يكون لها موضع الحرف مطلقا. يمكن للعملاء انصات ل TextChangedEventإعلام عن أي إلى محتوى نصي يعملون مع.
System.Windows.Automation.AutomationTextAttribute Class	يستخدم إلى تعريف السمات تنسيق نطاق نص.

موفر TextPattern لواجهة برمجة تطبيقات

واجه المستخدم العناصر أو عناصر التحكم التي تدعم TextPatternعن طريق تطبيق ITextProviderو ITextRangeProviderواجهات، أما الأصل أو إلى Microsoft UI Automationوكلاء، تكون قادرة على عرض معلومات مُفصل سمة لأي نص التي تحتوي عليها بالإضافة إلى توفير قوة إمكانيات التنقل.

TextPatternالموفر لم يكن لدعم الجميع السمات نص إذا كان عنصر تحكم تفتقر دعما لالسمات معينة.

TextPatternيجب أن يعتمد موفر GetSelectionو Selectيعمل إذا عنصر تحكم يعتمد تحديد نص أو موضع رأس المؤشر نص (أو علامة إقحام النظام) داخل ناحية نص. إذا كان عنصر تحكم لا يعتمد هذه الوظيفة ثم فإنه لا يحتاج لدعم أي من هاتين الطريقتين. ومع ذلك، عنصر تحكم يجب أن يعرض نوع تحديد نص يعتمد ذلك من خلال تطبيق SupportedTextSelectionخاصية.

TextPatternدائماً يجب أن يعتمد موفر TextUnitثوابت Characterو Documentالإضافة الأخرى TextUnitالثوابت هو قادرة على دعم.

ملاحظة
قد تخطي الموفر دعم محددة TextUnitبتأجيل إلى التالي الأكبر TextUnitمعتمدة بالترتيب التالي: Character و Format و Word و Line و Paragraph و Page و Document.

ITextProvider Interface	كشف أساليب، وخصائص و السمات التي تدعم TextPatternفي تطبيقات العميل (راجع ITextProvider).
ITextRangeProvider Interface	يمثل امتداد النص في مورد نص (انظر ITextRangeProvider).
System.Windows.Automation.TextPatternIdentifiers Class	يحتوي على قيم التي تستخدم كـ معرفات لموفري نص (انظر TextPatternIdentifiers).

الأمان

UI Automationتم تصميم بنية بالأمان بعين الاعتبار (انظر واجه المستخدم أتمتة نظرة عامة حول الالأمان). على الرغم من ذلك، تتطلب الفئات TextPattern الموصوفة في هذه نظرة عامة حول بعض اعتبارات الأمان الخاصة.

• Microsoft UI Automationموفري نص توفير واجهات للقراءة فقط وعدم توفير القدرة على إلى تغيير النص الموجود في عنصر تحكم.

• عملاء واجه المستخدم التنفيذ التلقائي يمكنك فقط استخدام Microsoft UI Automationإذا كانت عبارة عن "الثقه الكامله". مثال على ذلك سيكون "سطح مكتب تسجيل الدخول إلى" المحمية، الموقع تعرف فقط و موثوق بها يمكن تشغيل التطبيقات.

• يجب أن تكون على علم بأن الجميع المعلومات اختارت كشف في عناصر التحكم الخاصة بها من خلال المطورين من s "التنفيذ التلقائي لواجهة مستخدم" موفر Microsoft UI Automationهو العامة بشكل أساسي ويمكن الوصول إليه بالكامل بتعليمات برمجية غير ذلك. Microsoft UI Automationيجعل لا يوجد جهد إلى تحديد مدى جدارة الثقة أيAuإلىmation واجهة مستخدم عميل و من موفر Auإلىmation واجهة المستخدم ولذلك يجب أن لا بتعريض المحمية المحتوى أو الحساسة معلومات نصية (مثل حقول كلمة المرور).

• واحد التغييرات الأكثر أهمية في الأمان Windows Vistaهو نطاق واسع يشار إليها“ "الآمنة إدخال" ” الذي يشمل تقنيات مثل لديها امتيازات أقل (أو محدود) حسابات مستخدم "(LUA)" واجهة المستخدم المستوى الامتياز "هو olation (UIPI).

  • يمنع UIPI برنامج واحد من التحكم و/او مراقبة آخر برنامج“ المميز ” أكثر، منع الهجمات رسالة نافذة العمليات المشتركة التي بانتحال إدخال مستخدم.

  • يعين LUA حدود تشغيل الامتيازات للتطبيقات التي يتم تشغيله بواسطة المستخدمين في مجموعة Administrators (المسؤولون) (Administrators). بالضرورة لن يكون لتطبيقات مسؤول امتيازات، ولكن سيتم تشغيل بدلاً من ذلك بأقل امتيازات الضرورية. consequence، قد يكون هناك بعض قيود مفروضة في سيناريوهات LUA. سلسلة اقتطاع (سلاسل TextPattern ما فيه)، الموقع قد يستلزم الأمر الأكثر الملاحظ إلى تحديد الحجم السلاسل التي يتم استردادها من تطبيقات administraإلىr-level الموقع أنها لا يتم فرض إلى يخصص ذاكرة إلى النقطة لتعطيل تطبيق.

الأداء

ولأن يعتمد TextPattern تشغيل المكالمات عملية مشتركة لمعظم الوظائف، إلا أنه لا يوفر إليه تخزين مؤقت لتحسين الأداء عند معالجة المحتوى. هذا عكس الأخرى s نمط عنصر التحكم في Microsoft UI Automationالتي يمكن الوصول إلى استخدام GetCachedPatternأو TryGetCachedPatternالأساليب.

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

مصطلحات TextPattern

• السمة
  صفات تنسيق نطاق نص (ل مثال، IsItalicAttributeأو FontNameAttribute).

• نطاق degenerate
  نطاق degenerate هو نطاق نص فارغ أو صفر حرفاً. لأغراض TextPattern التحكم في نموذج، نص الإدراج يؤشر (أو علامة إقحام النظام) هو نطاق degenerate بعين الاعتبار. في حالة عدم وجود أي نص هو محددة، GetSelectionتقوم بإرجاع نطاق degenerate عند يؤشر الإدراج للنص و RangeFromPointستقوم بإرجاع نطاق degenerate كبه يؤشر نهاية البداية. RangeFromChildوGetVisibleRangesقد ترجع نطاقات degenerate عندما يتعذر العثور على الموفر نص أي نطاق نص التي تتطابق مع الشرط المعطى. يمكن استخدام هذا النطاق degenerate كـ نقطة نهاية بداية داخل موفر نص. FindText and FindAttribute return a null reference (Nothing in Microsoft Visual Basic .NET) to avoid confusion with a discovered range versus a degenerate range.

• كائن مضمّن
  هناك الثاني أنواع الكائنات المضمنة في UI Automationنموذج نص. أنها تتكون من عناصر المحتوى text-bكـed مثل كـ ارتباطات تشعبية أو جداول وعناصر التحكم عناصر مثل كـ الصور والأزرار. لمزيد من المعلومات المفصلة، راجع المضمن للوصول إلى الكائنات باستخدام واجه المستخدم التنفيذ التلقائي.

• نقطة النهاية
  مطلق Startأو Endأشر نطاق نص داخل حاوية نص.

يوضح ما يلي التعيين من يبدأ ونقاط النهاية.

• TextRange
  تمثيل لفترة نص، مع البدء و نقاط النهاية، في حاوية نص المقترن بكافة سمات بما في ذلك و وظيفة.

• TextUnit
  وحدة نص (حرف، كلمة أو سطر أو فقرة) المستخدم للتنقل خلال الأجزاء المنطقية نطاق نص المعرفة مسبقاً.

راجع أيضًا:

المهام

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

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

المبادئ

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

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

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

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

موارد أخرى

نص الالخدمات إطار عمل