ControlStyles Wyliczenie

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa styl i zachowanie kontrolki.

To wyliczenie obsługuje bitową kombinację jego wartości składowych.

public enum class ControlStyles

[System.Flags]
public enum ControlStyles

[<System.Flags>]
type ControlStyles =

Public Enum ControlStyles

Dziedziczenie: Object

ValueType

Enum
ControlStyles

Atrybuty: FlagsAttribute

Pola

AllPaintingInWmPaint	8192	Jeśli `true`kontrolka ignoruje komunikat okna WM_ERASEBKGND w celu zmniejszenia migotania. Ten styl należy zastosować tylko wtedy, gdy UserPaint bit jest ustawiony na `true`wartość .
ApplyThemingImplicitly	524288
CacheText	16384	Jeśli `true`element , kontrolka przechowuje kopię tekstu, a nie z każdej potrzebnej Handle kopii tekstu. Ten styl domyślnie ma wartość `false`. To zachowanie poprawia wydajność, ale utrudnia synchronizowanie tekstu.
ContainerControl	1	Jeśli `true`, kontrolka jest kontrolką podobną do kontenera.
DoubleBuffer	65536	Jeśli `true`rysunek jest wykonywany w buforze, a po jego zakończeniu wynik jest zwracany do ekranu. Buforowanie podwójne zapobiega migotaniu spowodowanego ponownym rysowaniem kontrolki. Jeśli ustawisz wartość DoubleBuffer`true`, należy również ustawić wartość UserPaint i AllPaintingInWmPaint na `true`.
EnableNotifyMessage	32768	Jeśli `true`metoda jest wywoływana OnNotifyMessage(Message) dla każdego komunikatu wysyłanego do kontrolki WndProc(Message). Ten styl domyślnie ma wartość `false`. EnableNotifyMessage nie działa w częściowej relacji zaufania.
FixedHeight	64	Jeśli `true`kontrolka ma stałą wysokość podczas automatycznego skalowania. Jeśli na przykład operacja układu próbuje zmienić skalę kontrolki, aby uwzględnić nową Fontkontrolkę, kontrolka pozostaje niezmieniona Height .
FixedWidth	32	Jeśli `true`kontrolka ma stałą szerokość podczas automatycznego skalowania. Jeśli na przykład operacja układu próbuje zmienić skalę kontrolki, aby uwzględnić nową Fontkontrolkę, kontrolka pozostaje niezmieniona Width .
Opaque	4	Jeśli `true`kontrolka jest rysowana nieprzezroczyste, a tło nie jest malowane.
OptimizedDoubleBuffer	131072	Jeśli `true`kontrolka jest najpierw rysowana do buforu, a nie bezpośrednio na ekranie, co może zmniejszyć migotanie. Jeśli ustawisz tę właściwość na `true`wartość , należy również ustawić `true`wartość AllPaintingInWmPaint .
ResizeRedraw	16	Jeśli `true`kontrolka zostanie ponownie narysowana po zmianie rozmiaru.
Selectable	512	Jeśli `true`, kontrolka może otrzymać fokus.
StandardClick	256	Jeśli `true`kontrolka implementuje standardowe Click zachowanie.
StandardDoubleClick	4096	Jeśli `true`kontrolka implementuje standardowe DoubleClick zachowanie. Ten styl jest ignorowany, jeśli StandardClick bit nie jest ustawiony na `true`wartość .
SupportsTransparentBackColor	2048	Jeśli `true`kontrolka akceptuje BackColor element ze składnikiem alfa o wartości mniejszej niż 255, aby symulować przezroczystość. Przezroczystość będzie symulowana tylko wtedy, gdy UserPaint bit jest ustawiony na `true` , a kontrolka nadrzędna jest pochodna .Control
UserMouse	1024	Jeśli `true`kontrolka wykonuje własne przetwarzanie myszy, a zdarzenia myszy nie są obsługiwane przez system operacyjny.
UserPaint	2	Jeśli `true`, kontrolka maluje się zamiast systemu operacyjnego. Jeśli `false`zdarzenie Paint nie zostanie zgłoszone. Ten styl ma zastosowanie tylko do klas pochodzących z Controlklasy .
UseTextForAccessibility	262144	Określa, że wartość właściwości kontrolki `Text` , jeśli jest ustawiona, określa domyślną nazwę active accessibility i klawisz skrótu kontrolki.

Przykłady

W poniższym przykładzie pokazano użycie z ControlStyles zdarzeniem 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

Uwagi

Kontrolki używają tego wyliczenia w różnych właściwościach i metodach do określania funkcjonalności. Kontrolka może włączyć styl, wywołując SetStyle metodę i przekazując odpowiedni ControlStyles bit (lub bity) oraz wartość logiczną, aby ustawić bity na . Na przykład poniższy wiersz kodu Języka Visual Basic umożliwia podwójne buforowanie.

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

Jeśli bit AllPaintingInWmPaint jest ustawiony na true, komunikat okna WM_ERASEBKGND jest ignorowany, a metody OnPaintBackground i OnPaint są wywoływane bezpośrednio z komunikatu okna WM_PAINT. Zazwyczaj zmniejsza to migotanie, chyba że inne kontrolki wysyłają komunikat okna WM_ERASEBKGND do kontrolki. Możesz wysłać komunikat okna WM_ERASEBKGRND, aby osiągnąć efekt pseudo-przezroczysty podobny do SupportsTransparentBackColor; na przykład element z płaskim wyglądem ToolBar robi to.

Aby w pełni włączyć podwójne buforowanie, można ustawić parametr OptimizedDoubleBuffer i AllPaintingInWmPaint bitów na truewartość . Jednak preferowaną metodą włączania podwójnego buforowania, która daje ten sam wynik, jest ustawienie DoubleBuffered właściwości kontrolki na true.

Jeśli bit SupportsTransparentBackColor jest ustawiony na true, a BackColor parametr jest ustawiony na kolor, którego składnik alfa jest mniejszy niż 255, symuluje przezroczystość, OnPaintBackground prosząc kontrolkę nadrzędną o malowanie tła. To nie jest prawdziwa przejrzystość.

Uwaga

Jeśli istnieje inna kontrolka między kontrolką a jej elementem nadrzędnym, bieżąca kontrolka nie będzie pokazywać kontrolki w środku.

Gdy bit UserMouse jest ustawiony na truewartość , nadal są wywoływane następujące metody: Control.OnMouseDown, , Control.OnMouseUp, Control.OnMouseMove Control.OnMouseLeave Control.OnMouseEnter Control.OnMouseHoveri .Control.OnMouseWheel

Po kliknięciu kontrolki, jeśli bit StandardClick jest ustawiony na trueControl.OnClick metodę jest wywoływana Control.Click i zgłasza zdarzenie. Po dwukrotnym kliknięciu kontrolki i ustawieniu bitów StandardClick i StandardDoubleClick na truewartość , kliknięcie zostanie przekazane do DoubleClick zdarzenia. Control.OnDoubleClick Następnie metoda jest wywoływana i zgłasza Control.DoubleClick zdarzenie. Kontrolka może jednak wywoływać OnClick lub OnDoubleClick bezpośrednio niezależnie od wartości bitów StandardClick i StandardDoubleClick. Aby uzyskać więcej informacji na temat kliknięć kontrolek i dwukrotnego kliknięcia, zobacz Control.Click tematy i Control.DoubleClick .

Gdy bit UseTextForAccessibility jest ustawiony i istnieje wartość we właściwości kontrolki Text , wartość właściwości kontrolki Text określa domyślną nazwę aktywnej dostępności i klawisz skrótu kontrolki. W przeciwnym razie zostanie użyty tekst poprzedniej Label kontrolki. Ten styl jest domyślnie ustawiany. Niektóre wbudowane typy kontrolek, takie jak TextBox i ComboBox, zresetuj ten styl, aby Text właściwość tych kontrolek nie była używana przez aktywne ułatwienia dostępu.

Dotyczy

Udostępnij za pośrednictwem