IRangeValueProvider.SetValue(Double) Methode

Definition

Namespace:

System.Windows.Automation.Provider

Assembly:

UIAutomationProvider.dll

Legt den Wert des Steuerelements fest.

public:
 void SetValue(double value);

public void SetValue (double value);

abstract member SetValue : double -> unit

Public Sub SetValue (value As Double)

Parameter

value

Double

Der festzulegende Wert.

Ausnahmen

ArgumentOutOfRangeException

Wenn value kleiner ist als der Mindestwert oder größer als der maximale Wert des Steuerelements.

Beispiele

Das folgende Beispiel zeigt eine mögliche Implementierung dieser Methode für ein benutzerdefiniertes Steuerelement. Das benutzerdefinierte Steuerelement zeigt seinen Bereichswert über den Alphawert seiner Basisfarbe an.

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

Hinweise

Der tatsächliche Wertsatz hängt von der Steuerungsimplementierung ab. Das Steuerelement kann das angeforderte value auf- oder herunterrunden.

Weitere Informationen

• Implementieren des RangeValue-Steuerelementmusters der Benutzeroberflächenautomatisierung