ControlStyles 列舉

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

指定控制項的樣式和行為。

此列舉支援其成員值的位元組合。

public enum class ControlStyles

[System.Flags]
public enum ControlStyles

[<System.Flags>]
type ControlStyles =

Public Enum ControlStyles

繼承: Object

ValueType

Enum
ControlStyles

屬性: FlagsAttribute

欄位

AllPaintingInWmPaint	8192	如果為 `true`，控制項會忽略視窗訊息 WM_ERASEBKGND 以減少閃爍。只有在 UserPaint 位元設定為 `true` 時，才應套用此樣式。
ApplyThemingImplicitly	524288
CacheText	16384	如果為 `true`，控制項會保留文字的複本，而不是在每次需要時從 Handle 取得。此樣式預設為 `false`。此行為可以改進效能，但會難以維持文字同步。
ContainerControl	1	如果為 `true`，控制項為類容器控制項。
DoubleBuffer	65536	如果為 `true`，會在緩衝區中執行繪製，並在完成之後，將結果輸出到畫面。雙重緩衝可防止控制項重繪造成的閃爍。如果您將 DoubleBuffer 設為 `true`，您也應該將 UserPaint 和 AllPaintingInWmPaint 設為 `true`。
EnableNotifyMessage	32768	如果為 `true`，每個傳送至控制項之 WndProc(Message) 的訊息會呼叫 OnNotifyMessage(Message) 方法。此樣式預設為 `false`。 EnableNotifyMessage 無法在部分信任的情況執行。
FixedHeight	64	如果為 `true`，當自動調整時控制項為固定高度。例如，如果配置作業嘗試要調整控制項以容納新的 Font，則控制項的 Height 會維持不變。
FixedWidth	32	如果為 `true`，當自動調整時控制項為固定寬度。例如，如果配置作業嘗試要調整控制項以容納新的 Font，則控制項的 Width 會維持不變。
Opaque	4	如果為 `true`，控制項會繪製為不透明且不會繪製背景。
OptimizedDoubleBuffer	131072	如果為 `true`，控制項會先繪製到緩衝區，而非直接繪製到螢幕，這可減少閃爍。如果您將此屬性設為 `true`，您也應該將 AllPaintingInWmPaint 設為 `true`。
ResizeRedraw	16	如果為 `true`，控制項調整大小時會重繪。
Selectable	512	如果為 `true`，控制項可以取得焦點。
StandardClick	256	如果為 `true`，控制項會實作標準的 Click 行為。
StandardDoubleClick	4096	如果為 `true`，控制項會實作標準的 DoubleClick 行為。如果 StandardClick 位元並未設為 `true`，則會忽略此樣式。
SupportsTransparentBackColor	2048	如果為 `true`，控制項可接受 BackColor 與小於 255 的 Alpha 元件以模擬透明度。僅有 UserPaint 位元設為 `true` 且父控制項衍生自 Control 時，才會模擬透明度。
UserMouse	1024	如果為 `true`，控制項會進行其本身的滑鼠處理，且作業系統不會處理滑鼠事件。
UserPaint	2	如果為 `true`，控制項會繪製本身，而不是由作業系統進行。如果為 `false`，就不會引發 Paint 事件。此樣式僅會套用至衍生自 Control 的類別。
UseTextForAccessibility	262144	指定控制項的 `Text` 屬性值，如果設定，會決定控制項的預設 Active Accessibility 名稱和快速鍵。

範例

下列範例示範搭配 StyleChanged 事件的用法 ControlStyles 。

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

備註

控制項會在各種屬性和方法中使用這個列舉來指定功能。控制項可以呼叫方法來啟用樣式， SetStyle 並傳入適當的 ControlStyles 位 (或位) 和布林值，以將位 () 設定為。例如，下列一行 Visual Basic 程式碼會啟用雙緩衝處理。

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

如果 AllPaintingInWmPaint 位設定為 true ，則會忽略視窗訊息WM_ERASEBKGND，而且和 OnPaintBackground OnPaint 方法都會直接從視窗訊息WM_PAINT呼叫。除非其他控制項WM_ERASEBKGND傳送視窗訊息給控制項，否則這通常會減少閃爍。您可以將視窗訊息傳送WM_ERASEBKGRND，以達到類似 SupportsTransparentBackColor 的虛擬透明效果;例如， ToolBar 具有一般外觀的會執行此動作。

若要完全啟用雙緩衝處理，您可以將 OptimizedDoubleBuffer 和 AllPaintingInWmPaint 位設定為 true 。不過，啟用雙精度緩衝的慣用方法會產生相同的結果，就是將控制項的屬性設定 DoubleBuffered 為 true 。

如果 SupportsTransparentBackColor 位設定為 true ，且 BackColor 設定為 Alpha 元件小於 255 的色彩， OnPaintBackground 則會要求其父控制項繪製背景來模擬透明度。這不是真正的透明度。

注意

如果控制項與其父控制項之間有另一個控制項，目前的控制項將不會在中間顯示控制項。

當 UserMouse 位設定為 true 時，仍會呼叫下列方法： Control.OnMouseDown 、 Control.OnMouseUp 、 Control.OnMouseEnter 、 Control.OnMouseMove 、、 Control.OnMouseHover 、 Control.OnMouseLeave 和 Control.OnMouseWheel 。

按一下控制項時，如果將 StandardClick 位設定為 true 方法， Control.OnClick 則會引發 Control.Click 事件。按兩下控制項，並將 StandardClick 和 StandardDoubleClick 位都設定為 true 時，按一下會傳遞至 DoubleClick 事件。接著會 Control.OnDoubleClick 呼叫方法，並引發 Control.DoubleClick 事件。不過，控制項可以呼叫或 OnDoubleClick 直接呼叫 OnClick ，而不論 StandardClick 和 StandardDoubleClick 位值為何。如需有關控制項按一下和按兩下行為的詳細資訊，請參閱 Control.Click 和 Control.DoubleClick 主題。

當設定 UseTextForAccessibility 位且控制項 Text 的屬性中有值時，該控制項的屬性值會決定控制項 Text 的預設 Active Accessibility 名稱和快速鍵。否則，將會改用上述 Label 控制項的文字。預設會設定此樣式。某些內建控制項類型，例如 TextBox 和 ComboBox ，請重設此樣式， Text 讓 Active Accessibility 不會使用這些控制項的屬性。

適用於

共用方式為

ControlStyles 列舉

定義

欄位

範例

備註

適用於

另請參閱

其他資源