IRangeValueProvider.SetValue(Double) Método

Definição

Namespace:

System.Windows.Automation.Provider

Assembly:

UIAutomationProvider.dll

Define o valor do controle.

public:
 void SetValue(double value);

public void SetValue (double value);

abstract member SetValue : double -> unit

Public Sub SetValue (value As Double)

Parâmetros

value

Double

O valor a ser definido.

Exceções

ArgumentOutOfRangeException

Quando value é menor que o valor mínimo ou maior que o valor máximo do controle.

Exemplos

O exemplo a seguir mostra uma possível implementação desse método para um controle personalizado. O controle personalizado exibe seu valor de intervalo por meio do valor alfa de sua cor base.

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

Comentários

O conjunto de valores real depende da implementação do controle. O controle pode arredondar a solicitação value para cima ou para baixo.

Confira também

• Implementando o padrão de controle RangeValue de interface de usuário