IRangeValueProvider.SetValue(Double) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta il valore del controllo.
public:
void SetValue(double value);public void SetValue (double value);abstract member SetValue : double -> unitPublic Sub SetValue (value As Double)Parametri
- value
- Double
Il valore da impostare.
Eccezioni
Quando value è inferiore al valore minimo o superiore al valore massimo del controllo.
Esempio
Nell'esempio seguente viene illustrata una possibile implementazione di questo metodo per un controllo personalizzato. Il controllo personalizzato visualizza il valore di intervallo tramite il valore alfa del colore di 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
Commenti
Il valore effettivo impostato dipende dall'implementazione del controllo. Il controllo può arrotondare l'oggetto richiesto value verso l'alto o verso il basso.
