ControlStyles Enumeración

Definición

public enum class ControlStyles

[System.Flags]
public enum ControlStyles

[<System.Flags>]
type ControlStyles = 

Public Enum ControlStyles

Herencia

Object

ValueType

Enum

ControlStyles

Atributos

FlagsAttribute

Campos

Ejemplos

En el ejemplo siguiente se muestra un uso de ControlStyles con el StyleChanged evento .

private:
   // Set the 'FixedHeight' and 'FixedWidth' styles to false.
   void MyForm_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      this->SetStyle( ControlStyles::FixedHeight, false );
      this->SetStyle( ControlStyles::FixedWidth, false );
   }

   void RegisterEventHandler()
   {
      this->StyleChanged += gcnew EventHandler( this, &MyForm::MyForm_StyleChanged );
   }

   // Handle the 'StyleChanged' event for the 'Form'.
   void MyForm_StyleChanged( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      MessageBox::Show( "The style releated to the 'Form' has been changed" );
   }

// Set the 'FixedHeight' and 'FixedWidth' styles to false.
private void MyForm_Load(object sender, EventArgs e)
{
   this.SetStyle(ControlStyles.FixedHeight, false);
   this.SetStyle(ControlStyles.FixedWidth, false);
}

private void RegisterEventHandler()
{
   this.StyleChanged += new EventHandler(MyForm_StyleChanged);
}

// Handle the 'StyleChanged' event for the 'Form'.
private void MyForm_StyleChanged(object sender, EventArgs e)
{
   MessageBox.Show("The style releated to the 'Form' has been changed");
}

' Set the 'FixedHeight' and 'FixedWidth' styles to false.
Private Sub MyForm_Load(sender As Object, e As EventArgs)
   Me.SetStyle(ControlStyles.FixedHeight, False)
   Me.SetStyle(ControlStyles.FixedWidth, False)
End Sub

Private Sub RegisterEventHandler()
   AddHandler Me.StyleChanged, AddressOf MyForm_StyleChanged
End Sub

' Handle the 'StyleChanged' event for the 'Form'.
Private Sub MyForm_StyleChanged(sender As Object, e As EventArgs)
   MessageBox.Show("The style releated to the 'Form' has been changed")
End Sub

Comentarios

Los controles usan esta enumeración en varias propiedades y métodos para especificar la funcionalidad. Un control puede habilitar un estilo llamando al SetStyle método y pasando el bit adecuado ControlStyles (o bits) y el valor booleano en el que establecer los bits. Por ejemplo, la siguiente línea de código de Visual Basic habilitaría el almacenamiento en búfer doble.

myControl.SetStyle(UserPaint Or AllPaintingInWmPaint Or DoubleBuffer, True)  

Si el bit AllPaintingInWmPaint se establece trueen , se omite el mensaje de la ventana WM_ERASEBKGND y se llama a ambos OnPaintOnPaintBackground métodos directamente desde el mensaje de la ventana WM_PAINT. Esto generalmente reduce el parpadeo a menos que otros controles envíen el mensaje de la ventana WM_ERASEBKGND al control. Puede enviar el mensaje de ventana WM_ERASEBKGRND para lograr un efecto pseudotransparente similar a SupportsTransparentBackColor; por ejemplo, un ToolBar con apariencia plana lo hace.

Para habilitar completamente el almacenamiento en búfer doble, puede establecer los bits OptimizedDoubleBuffer y AllPaintingInWmPaint en true. Sin embargo, el método preferido para habilitar el almacenamiento en búfer doble, que produce el mismo resultado, es establecer la DoubleBuffered propiedad para el control trueen .

Si el bit SupportsTransparentBackColor se establece trueen y BackColor se establece en un color cuyo componente alfa es inferior a 255, OnPaintBackground simulará la transparencia pidiendo a su control primario que pinte el fondo. Esto no es una transparencia verdadera.

Cuando el bit UserMouse se establece en , se sigue llamando a truelos métodos siguientes: Control.OnMouseDown, , Control.OnMouseEnterControl.OnMouseUp, Control.OnMouseMove, Control.OnMouseHover, Control.OnMouseLeavey Control.OnMouseWheel.

Cuando se hace clic en el control, si se establece true el bit StandardClick en el Control.OnClick método y genera el Control.Click evento. Cuando se hace doble clic en el control y los bits StandardClick y StandardDoubleClick se establecen trueen , el clic se pasa al DoubleClick evento. A continuación, se llama al Control.OnDoubleClick método y genera el Control.DoubleClick evento . Sin embargo, el control puede llamar OnClick a o OnDoubleClick directamente independientemente de los valores de bits StandardClick y StandardDoubleClick. Para obtener más información sobre el control de los comportamientos de clic y doble clic, consulte los Control.Click temas y Control.DoubleClick .

Cuando se establece el bit UseTextForAccessibility y hay un valor en la propiedad del Text control, el valor de esa Text propiedad determina el nombre de accesibilidad activo predeterminado del control y la tecla de método abreviado. De lo contrario, se usará en su lugar el texto del control anterior Label . Este estilo se establece de forma predeterminada. Ciertos tipos de control integrados, como TextBox y ComboBox, restablecen este estilo para que la Text propiedad de esos controles no la use la accesibilidad activa.

Se aplica a

Consulte también

• SetStyle(ControlStyles, Boolean)
• GetStyle(ControlStyles)