IRangeValueProvider.SetValue(Double) Метод

Определение

Пространство имен:

System.Windows.Automation.Provider

Сборка:

UIAutomationProvider.dll

Задает значение элемента управления.

public:
 void SetValue(double value);

public void SetValue (double value);

abstract member SetValue : double -> unit

Public Sub SetValue (value As Double)

Параметры

value

Double

Задаваемое значение.

Исключения

ArgumentOutOfRangeException

Когда value меньше минимального или больше максимального значения элемента.

Примеры

В следующем примере показана одна из возможных реализаций этого метода для пользовательского элемента управления. Пользовательский элемент управления отображает значение диапазона через альфа-значение базового цвета.

/// <summary>
/// Sets the value of the control.
/// </summary>
/// <param name="value">
/// The value to set the control to.
/// </param>
/// <remarks>
/// For the purposes of this sample, the custom control displays 
/// its value through the alpha setting of its base color.
/// </remarks>
public void SetValue(double value)
{
    if (value < Minimum | value > Maximum)
    {
        throw new ArgumentOutOfRangeException();
    }
    else
    {
        Color color = customControl.controlColor;
        // Invoke control method on separate thread to avoid 
        // clashing with UI.
        // Use anonymous method for simplicity.
        this.customControl.Invoke(new MethodInvoker(delegate()
        {
            customControl.controlColor =
                Color.FromArgb((int)value, color);
            customControl.Refresh();
        }));
    }
}

''' <summary>
''' Sets the value of the control.
''' </summary>
''' <param name="value">
''' The value to set the control to.
''' </param>
''' <remarks>
''' For the purposes of this sample, the custom control displays 
''' its value through the alpha setting of its base color.
''' </remarks>
Public Sub SetValue(ByVal value As Double) Implements IRangeValueProvider.SetValue
    If value < Minimum Or value > Maximum Then
        Throw New ArgumentOutOfRangeException()
    Else
        Dim color As Color = customControl.controlColor
        ' Invoke control method on separate thread to avoid 
        ' clashing with UI.
        ' Use anonymous method for simplicity.
        Me.customControl.Invoke(New MethodInvoker(Sub()
            customControl.controlColor = Color.FromArgb(CInt(Fix(value)), color)
            customControl.Refresh()
        End Sub))
    End If
End Sub

Комментарии

Фактический набор значений зависит от реализации элемента управления. Элемент управления может округлить запрошенный value объект вверх или вниз.

См. также раздел

• Реализация шаблона элемента управления RangeValue автоматизации пользовательского интерфейса