IRangeValueProvider.SetValue(Double) Metoda

Definice

Obor názvů:

System.Windows.Automation.Provider

Sestavení:

UIAutomationProvider.dll

Nastaví hodnotu ovládacího prvku.

public:
 void SetValue(double value);

public void SetValue (double value);

abstract member SetValue : double -> unit

Public Sub SetValue (value As Double)

Parametry

value

Double

Hodnota k nastavení.

Výjimky

ArgumentOutOfRangeException

Pokud value je menší než minimum nebo větší než maximální hodnota ovládacího prvku.

Příklady

Následující příklad ukazuje jednu možnou implementaci této metody pro vlastní ovládací prvek. Vlastní ovládací prvek zobrazí hodnotu rozsahu prostřednictvím alfa hodnoty základní barvy.

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

Poznámky

Skutečná sada hodnot závisí na implementaci ovládacího prvku. Ovládací prvek může požadovaný prvek zaokrouhlit value nahoru nebo dolů.

Viz také

• Implementace vzoru ovládacích prvků RangeValue pro automatizaci uživatelského rozhraní