IRangeValueProvider.SetValue(Double) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Establece el valor del control.
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
Valor que se va a establecer.
Excepciones
Cuando value
es menor que el mínimo o mayor que el valor máximo del control.
Ejemplos
En el ejemplo siguiente se muestra una posible implementación de este método para un control personalizado. El control personalizado muestra su valor de intervalo a través del valor alfa de su color 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
Comentarios
El conjunto de valores real depende de la implementación del control. El control puede redondear la solicitud value
hacia arriba o hacia abajo.