IRangeValueProvider.SetValue(Double) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation.Provider

Zestaw:

UIAutomationProvider.dll

Ustawia wartość kontrolki.

public:
 void SetValue(double value);

public void SetValue (double value);

abstract member SetValue : double -> unit

Public Sub SetValue (value As Double)

Parametry

value

Double

Wartość do ustawienia.

Wyjątki

ArgumentOutOfRangeException

Gdy value wartość jest mniejsza niż minimalna lub większa niż maksymalna wartość kontrolki.

Przykłady

Poniższy przykład przedstawia jedną z możliwych implementacji tej metody dla kontrolki niestandardowej. Kontrolka niestandardowa wyświetla swoją wartość zakresu przez wartość alfa koloru podstawowego.

/// <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

Uwagi

Rzeczywisty zestaw wartości zależy od implementacji kontrolki. Kontrolka może zaokrąglać żądane value w górę lub w dół.

Zobacz też

• Implementacja wzorca formantu RangeValue dla automatyzacji interfejsu użytkownika