This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

ScrollPattern.SetScrollPercent أسلوب

Visual Studio 2010

Sets the horizontal and/أو vertical scroll position كـ a percentage of the total content area within the AutomationElement.

مساحة الاسم:  System.Windows.Automation
التجميع:  UIAutomationClient (في UIAutomationClient.dll)

public void SetScrollPercent(
	double horizontalPercent,
	double verticalPercent
)

المعلمات

horizontalPercent
النوع: System.Double
النسبة إجمالي المنطقة الأفقية للمحتوى. NoScroll يجب أن يمرر الدخول إذا كان عنصر تحكم لا يمكن تمريره في هذا الاتجاه.
verticalPercent
النوع: System.Double
النسبة المئوية للإجمالي العمودي محتوى المنطقة. NoScroll يجب أن يمرر الدخول إذا كان عنصر تحكم لا يمكن تمريره في هذا الاتجاه.

استثناء:شرط
ArgumentException

القيمة التي لا يمكن تحويلها إلى مضاعفة هو الذي تم إدخاله.

ArgumentOutOfRangeException

القيمة أكبر من 100 أو أصغر من من 0 هو تمريره (باستثناء-1، الذي هو يساوي NoScroll). HorizontalScrollPercent و VerticalScrollPercentيتم normalized قيم إلى 0% أو 100%.

InvalidOperationException

محاولة هو التي تم إجراؤها على التمرير في الاتجاه غير معتمد.

Th هو أسلوب هو عندما يكون ذلك مفيداً فقط مساحة المحتوى في عنصر التحكم هو بقعة صغيرة من المساحة vهوible.

تمرير في القيمة NoScrollيشير إلى وجود لا التمرير في الاتجاه معين.

In the following example, a ScrollPattern control pattern is obtained from an AutomationElement and is then used to scroll the viewable region to the top left 'home' position of the content area.


///--------------------------------------------------------------------
/// <summary>
/// Obtains a ScrollPattern control pattern from an 
/// automation element.
/// </summary>
/// <param name="targetControl">
/// The automation element of interest.
/// </param>
/// <returns>
/// A ScrollPattern object.
/// </returns>
///--------------------------------------------------------------------
private ScrollPattern GetScrollPattern(
    AutomationElement targetControl)
{
    ScrollPattern scrollPattern = null;

    try
    {
        scrollPattern =
            targetControl.GetCurrentPattern(
            ScrollPattern.Pattern)
            as ScrollPattern;
    }
    // Object doesn't support the ScrollPattern control pattern
    catch (InvalidOperationException)
    {
        return null;
    }

    return scrollPattern;
}


...


///--------------------------------------------------------------------
/// <summary>
/// Obtains a ScrollPattern control pattern from an automation 
/// element and attempts to scroll to the 'home' position.
/// </summary>
/// <param name="targetControl">
/// The automation element of interest.
/// </param>
///--------------------------------------------------------------------
private void ScrollHome(AutomationElement targetControl)
{
    if (targetControl == null)
    {
        throw new ArgumentNullException(
            "AutomationElement argument cannot be null.");
    }

    ScrollPattern scrollPattern = GetScrollPattern(targetControl);

    if (scrollPattern == null)
    {
        return;
    }

    try
    {
        scrollPattern.SetScrollPercent(0, 0);
    }
    catch (InvalidOperationException)
    {
        // Control not able to scroll in the direction requested;
        // when scrollable property of that direction is False
        // TO DO: error handling.
    }
    catch (ArgumentOutOfRangeException)
    {
        // A value greater than 100 or less than 0 is passed in 
        // (except -1 which is equivalent to NoScroll).
        // TO DO: error handling.
    }
}


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0

NET Framework. Client Profile

مدعوم في: 4
إظهار: