IRangeValueProvider.SetValue(Double) Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll

Définit la valeur du contrôle.

public:
 void SetValue(double value);
public void SetValue (double value);
abstract member SetValue : double -> unit
Public Sub SetValue (value As Double)

Paramètres

value
Double

Valeur à définir.

Exceptions

ArgumentOutOfRangeException

Quand value est inférieure à la valeur minimale ou supérieure à la valeur maximale du contrôle.

Exemples

L’exemple suivant montre une implémentation possible de cette méthode pour un contrôle personnalisé. Le contrôle personnalisé affiche sa valeur de plage via la valeur alpha de sa couleur de 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

Remarques

Le jeu de valeurs réel dépend de l’implémentation du contrôle. Le contrôle peut arrondir les demandes vers value le haut ou vers le bas.

S’applique à

Voir aussi