ControlStyles Énumération

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ControlStyles.cs

Spécifie le style et le comportement d’un contrôle.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class ControlStyles

[System.Flags]
public enum ControlStyles

[<System.Flags>]
type ControlStyles = 

Public Enum ControlStyles

Héritage

Object

ValueType

Enum

ControlStyles

Attributs

FlagsAttribute

Champs

Nom	Valeur	Description
ContainerControl	1	Si true, le contrôle est un contrôle de type conteneur.
UserPaint	2	Si true, le contrôle se peint plutôt que le système d’exploitation qui le fait. Si false, l’événement Paint n’est pas déclenché. Ce style s’applique uniquement aux classes dérivées de Control.
Opaque	4	Si true, le contrôle est dessiné opaque et l’arrière-plan n’est pas peint.
ResizeRedraw	16	Si true, le contrôle est redessiné lorsqu’il est redimensionné.
FixedWidth	32	Si true, le contrôle a une largeur fixe lorsqu’il est mis à l’échelle automatiquement. Par exemple, si une opération de disposition tente de rescaler le contrôle pour prendre en charge un nouveau Font, le contrôle Width reste inchangé.
FixedHeight	64	Si true, le contrôle a une hauteur fixe lorsqu’il est mis à l’échelle automatiquement. Par exemple, si une opération de disposition tente de rescaler le contrôle pour prendre en charge un nouveau Font, le contrôle Height reste inchangé.
StandardClick	256	Si true, le contrôle implémente le comportement standard Click .
Selectable	512	Si true, le contrôle peut recevoir le focus.
UserMouse	1024	Si true, le contrôle effectue son propre traitement de la souris et les événements de la souris ne sont pas gérés par le système d’exploitation.
SupportsTransparentBackColor	2048	Si true, le contrôle accepte un BackColor composant alpha de moins de 255 pour simuler la transparence. La transparence sera simulée uniquement si le UserPaint bit est défini true et que le contrôle parent est dérivé de Control.
StandardDoubleClick	4096	Si true, le contrôle implémente le comportement standard DoubleClick . Ce style est ignoré si le StandardClick bit n’est pas défini truesur .
AllPaintingInWmPaint	8192	Si true, le contrôle ignore le message de fenêtre WM_ERASEBKGND pour réduire le scintillement. Ce style ne doit être appliqué que si le UserPaint bit est défini sur true.
CacheText	16384	Si true, le contrôle conserve une copie du texte plutôt que de l’obtenir à partir de chaque Handle fois qu’il est nécessaire. Ce style est défini par défaut sur false. Ce comportement améliore les performances, mais rend difficile la synchronisation du texte.
EnableNotifyMessage	32768	Si true, la OnNotifyMessage(Message) méthode est appelée pour chaque message envoyé au contrôle WndProc(Message). Ce style est défini par défaut sur false. EnableNotifyMessage ne fonctionne pas en confiance partielle.
DoubleBuffer	65536	Si true, le dessin est effectué dans une mémoire tampon et une fois terminé, le résultat est généré à l’écran. La double mise en mémoire tampon empêche le scintillement provoqué par le redessinage du contrôle. Si vous définissez trueDoubleBuffer sur , vous devez également définir UserPaint et AllPaintingInWmPaint sur true.
OptimizedDoubleBuffer	131072	Si true, le contrôle est d’abord dessiné vers une mémoire tampon plutôt que directement à l’écran, ce qui peut réduire le scintillement. Si vous définissez cette propriété truesur , vous devez également définir la trueAllPaintingInWmPaint valeur .
UseTextForAccessibility	262144	Spécifie que la valeur de la propriété du Text contrôle, si elle est définie, détermine le nom d’accessibilité actif et la touche de raccourci par défaut du contrôle.
ApplyThemingImplicitly	524288	Pour certains modes de couleur liés à l’interface utilisateur (mode sombre/mode clair), les contrôles peuvent choisir d’appliquer automatiquement les thèmes appropriés. En particulier, les contrôles qui utilisent des barres de défilement gérées par le système peuvent tirer parti de ce paramètre. Notez que l’utilisation de ces paramètres entraîne l’inactivité d’un thème spécifique à certains convertisseurs win32.

Exemples

L’exemple suivant illustre une utilisation de ControlStyles l’événement StyleChanged .

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

Remarques

Les contrôles utilisent cette énumération dans différentes propriétés et méthodes pour spécifier des fonctionnalités. Un contrôle peut activer un style en appelant la SetStyle méthode et en transmettant le ou les bits appropriés ControlStyles et la valeur booléenne à laquelle définir le ou les bits. Par exemple, la ligne suivante de code Visual Basic activerait la mise en mémoire tampon double.

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

Si le bit AllPaintingInWmPaint est défini truesur , le message de fenêtre WM_ERASEBKGND est ignoré et les deux OnPaintBackgroundOnPaint méthodes sont appelées directement à partir du message de fenêtre WM_PAINT. Cela réduit généralement le scintillement, sauf si d’autres contrôles envoient le message de fenêtre WM_ERASEBKGND au contrôle. Vous pouvez envoyer le message de fenêtre WM_ERASEBKGRND pour obtenir un effet pseudo-transparent similaire à SupportsTransparentBackColor ; par exemple, une ToolBar apparence plate fait cela.

Pour activer entièrement la mise en mémoire tampon double, vous pouvez définir les bits trueOptimizedDoubleBuffer et AllPaintingInWmPaint sur . Toutefois, la méthode préférée pour activer la mise en mémoire tampon double, qui génère le même résultat, consiste à définir la DoubleBuffered propriété du contrôle truesur .

Si le bit SupportsTransparentBackColor est défini truesur , et qu’il BackColor est défini sur une couleur dont le composant alpha est inférieur à 255, OnPaintBackground simule la transparence en demandant à son contrôle parent de peindre l’arrière-plan. Cette transparence n’est pas vraie.

Note

S’il existe un autre contrôle entre le contrôle et son parent, le contrôle actuel n’affiche pas le contrôle au milieu.

Lorsque le bit UserMouse est défini truesur , les méthodes suivantes sont toujours appelées : Control.OnMouseDown, , Control.OnMouseUp, Control.OnMouseEnter, Control.OnMouseMove, Control.OnMouseHover, , Control.OnMouseLeaveet Control.OnMouseWheel.

Lorsque le contrôle est cliqué, si le bit StandardClick est défini sur true la Control.OnClick méthode est appelé et qu’il déclenche l’événement Control.Click . Lorsque le contrôle est double-cliqué et que les bits StandardClick et StandardDoubleClick sont définis truesur , le clic est transmis à l’événement DoubleClick . Ensuite, la Control.OnDoubleClick méthode est appelée et déclenche l’événement Control.DoubleClick . Toutefois, le contrôle peut appeler OnClick ou OnDoubleClick directement quelles que soient les valeurs de bits StandardClick et StandardDoubleClick. Pour plus d’informations sur le contrôle, cliquez et double-cliquez sur les comportements, consultez les rubriques et Control.DoubleClick les Control.Click rubriques.

Lorsque le bit UseTextForAccessibility est défini et qu’il existe une valeur dans la propriété du Text contrôle, la valeur de la propriété de ce contrôle détermine le nom d’accessibilité actif et la touche de raccourci par défaut du Text contrôle. Sinon, le texte du contrôle précédent Label sera utilisé à la place. Ce style est défini par défaut. Certains types de contrôles intégrés, tels que TextBox et ComboBox, réinitialisent ce style afin que la Text propriété de ces contrôles ne soit pas utilisée par l’accessibilité active.

Voir aussi

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