IRangeValueProvider.SetValue(Double) Methode

Definition

Legt den Wert des Steuerelements fest.Sets the value of the control.

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.The value to set.

Ausnahmen

Wenn value kleiner ist als der Mindestwert oder größer als der maximale Wert des Steuerelements.When value is less than the minimum or greater than the maximum value of the control.

Beispiele

Das folgende Beispiel zeigt eine mögliche Implementierung dieser Methode für ein benutzerdefiniertes Steuerelement.The following example shows one possible implementation of this method for a custom control. Das benutzerdefinierte Steuerelement zeigt seinen Bereichs Wert über den Alpha-Wert seiner Basis Farbe an.The custom control displays its range value through the alpha value of its base color.

/// <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 Wert hängt von der Implementierung des Steuer Elements ab.The actual value set depends on the control implementation. Das Steuerelement kann die angeforderte value nach oben oder unten aufrunden.The control may round the requested value up or down.

Gilt für:

Siehe auch