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`，则控件接受 alpha 组件数小于 255 个的 BackColor 来模拟透明度。仅当将 UserPaint 位设置为 `true` 且父控件从 Control 派生时，才会模拟透明度。
UserMouse	1024	如果为 `true`，则将由控件而不是操作系统处理其自身的鼠标事件。
UserPaint	2	如果为 `true`，则会由控件而不是由操作系统来绘制控件自身。如果 `false`，则不会引发 Paint 事件。此样式仅适用于从 Control 派生的类。
UseTextForAccessibility	262144	指定控件的 `Text` 属性的值，若设置，则确定控件的默认 Active Accessibility 名称和快捷键。

示例

以下示例演示如何将与 ControlStyles 事件一起使用 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

注解

控件在各种属性和方法中使用此枚举来指定功能。控件可以通过调用 SetStyle 方法并传入相应的 ControlStyles 位 (或位) 和布尔值来启用样式，以将位 () 设置为。例如，以下 Visual Basic 代码行将启用双重缓冲。

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

如果将 AllPaintingInWmPaint 位设置为 true，则会忽略窗口消息WM_ERASEBKGND，并且 OnPaintBackground 直接从窗口消息WM_PAINT调用和 OnPaint 方法。这通常会减少闪烁，除非其他控件将窗口消息WM_ERASEBKGND发送到控件。可以WM_ERASEBKGRND发送窗口消息，以实现类似于 SupportsTransparentBackColor 的伪透明效果;例如， ToolBar 具有平面外观的执行此操作。

若要完全启用双缓冲，可以将 OptimizedDoubleBuffer 和 AllPaintingInWmPaint 位设置为 true。但是，启用双重缓冲（生成相同结果）的首选方法是将控件的属性设置为 DoubleBufferedtrue。

如果 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 事件。但是，无论 StandardClick 和 StandardDoubleClick 位值如何，控件都可以调用 OnClick 或 OnDoubleClick 直接。有关控件单击和双击行为的详细信息，请参阅 Control.Click 和 Control.DoubleClick 主题。

设置 UseTextForAccessibility 位并且控件的 Text 属性中有一个值时，该控件 Text 的属性的值将确定控件的默认 Active Accessibility 名称和快捷键。否则，将改用上述 Label 控件的文本。默认设置此样式。某些内置控件类型（如 TextBox 和 ComboBox）会重置此样式， Text 以便活动辅助功能不会使用这些控件的属性。

适用于

通过

ControlStyles 枚举

定义

字段

示例

注解

适用于

另请参阅

其他资源