ControlStyles Enumeration

Definition

public enum class ControlStyles

[System.Flags]
public enum ControlStyles

[<System.Flags>]
type ControlStyles = 

Public Enum ControlStyles

Vererbung

Object

ValueType

Enum

ControlStyles

Attribute

FlagsAttribute

Felder

Beispiele

Im folgenden Beispiel wird die Verwendung von ControlStyles mit dem StyleChanged -Ereignis veranschaulicht.

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

Hinweise

Steuerelemente verwenden diese Enumeration in verschiedenen Eigenschaften und Methoden, um Funktionen anzugeben. Ein Steuerelement kann einen Stil aktivieren, indem es die SetStyle -Methode aufruft und das entsprechende ControlStyles Bit (oder bits) und den booleschen Wert übergibt, auf den die Bits festgelegt werden sollen. Beispielsweise würde die folgende Zeile von Visual Basic-Code die Doppelpufferung ermöglichen.

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

Wenn das AllPaintingInWmPaint-Bit auf truefestgelegt ist, wird die Fenstermeldung WM_ERASEBKGND ignoriert, und beide OnPaintBackgroundOnPaint Methoden werden direkt aus der Fenstermeldung WM_PAINT aufgerufen. Dadurch wird das Flackern in der Regel verringert, es sei denn, andere Steuerelemente senden die Fensternachricht WM_ERASEBKGND an das Steuerelement. Sie können die Fensternachricht WM_ERASEBKGRND senden, um einen pseudotransparenten Effekt ähnlich wie SupportsTransparentBackColor zu erzielen. Dies geschieht beispielsweise bei einem ToolBar mit flachem Erscheinungsbild.

Um die Doppelpufferung vollständig zu aktivieren, können Sie die Bits OptimizedDoubleBuffer und AllPaintingInWmPaint auf truefestlegen. Die bevorzugte Methode zum Aktivieren der doppelten Pufferung, die das gleiche Ergebnis ergibt, besteht jedoch darin, die DoubleBuffered -Eigenschaft für das -Steuerelement auf festzulegen true.

Wenn das SupportsTransparentBackColor-Bit auf truefestgelegt ist und auf BackColor eine Farbe festgelegt ist, deren Alphakomponente kleiner als 255 ist, simuliert die Transparenz, indem das übergeordnete Steuerelement aufgefordert wird, OnPaintBackground den Hintergrund zu zeichnen. Das ist keine wahre Transparenz.

Wenn das UserMouse-Bit auf truefestgelegt ist, werden die folgenden Methoden weiterhin aufgerufen: Control.OnMouseDown, , Control.OnMouseEnterControl.OnMouseUp, Control.OnMouseMove, Control.OnMouseHover, Control.OnMouseLeaveund Control.OnMouseWheel.

Wenn auf das Steuerelement geklickt wird, wird das StandardClick-Bit auf true die Control.OnClick Methode aufgerufen und löst das Control.Click Ereignis aus. Wenn auf das Steuerelement doppelt geklickt wird und sowohl die Bits StandardClick als auch StandardDoubleClick auf truefestgelegt sind, wird der Klick an das DoubleClick Ereignis übergeben. Dann wird die Control.OnDoubleClick -Methode aufgerufen und löst das Control.DoubleClick -Ereignis aus. Das Steuerelement kann jedoch unabhängig von den Bitwerten StandardClick und StandardDoubleClick direkt oder aufrufen OnClickOnDoubleClick . Weitere Informationen zu Steuerelement-Klick- und Doppelklickverhalten finden Sie in den Control.Click Themen und Control.DoubleClick .

Wenn das UseTextForAccessibility-Bit festgelegt ist und ein Wert in der -Eigenschaft des Steuerelements Text vorhanden ist, bestimmt der Wert der Eigenschaft dieses Text Steuerelements den Standardmäßignamen für aktive Barrierefreiheit und die Tastenkombination des Steuerelements. Andernfalls wird stattdessen der Text des vorherigen Label Steuerelements verwendet. Diese Formatvorlage ist standardmäßig festgelegt. Bestimmte integrierte Steuerelementtypen, z TextBox . B. und ComboBox, setzen diese Formatvorlage zurück, sodass die Text Eigenschaft dieser Steuerelemente nicht von der aktiven Barrierefreiheit verwendet wird.

Gilt für:

Weitere Informationen

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