Search
Module:
Directory

   Desktop Functions:

   Smart Device Functions:


Show Recent Changes
Subscribe (RSS)
Misc. Pages
Comments
FAQ
Helpful Tools
Playground
Suggested Reading
Website TODO List
Download Visual Studio Add-In

WindowStyles (Enums)
 
.
Summary
Defines the possible window style flags in Microsoft's API. These flags can be OR'd together to make more complex styles.

C# Definition:

  /// <summary>
  /// Window Styles.
  /// The following styles can be specified wherever a window style is required. After the control has been created, these styles cannot be modified, except as noted.
  /// </summary>
[Flags()]
private enum WindowStyles : uint
{
    /// <summary>The window has a thin-line border.</summary>
    WS_BORDER = 0x800000,

    /// <summary>The window has a title bar (includes the WS_BORDER style).</summary>
    WS_CAPTION = 0xc00000,

    /// <summary>The window is a child window. A window with this style cannot have a menu bar. This style cannot be used with the WS_POPUP style.</summary>
    WS_CHILD = 0x40000000,

    /// <summary>Excludes the area occupied by child windows when drawing occurs within the parent window. This style is used when creating the parent window.</summary>
    WS_CLIPCHILDREN = 0x2000000,

    /// <summary>
    /// Clips child windows relative to each other; that is, when a particular child window receives a WM_PAINT message, the WS_CLIPSIBLINGS style clips all other overlapping child windows out of the region of the child window to be updated.
    /// If WS_CLIPSIBLINGS is not specified and child windows overlap, it is possible, when drawing within the client area of a child window, to draw within the client area of a neighboring child window.
    /// </summary>
    WS_CLIPSIBLINGS = 0x4000000,

    /// <summary>The window is initially disabled. A disabled window cannot receive input from the user. To change this after a window has been created, use the EnableWindow function.</summary>
    WS_DISABLED = 0x8000000,

    /// <summary>The window has a border of a style typically used with dialog boxes. A window with this style cannot have a title bar.</summary>
    WS_DLGFRAME = 0x400000,

    /// <summary>
    /// The window is the first control of a group of controls. The group consists of this first control and all controls defined after it, up to the next control with the WS_GROUP style.
    /// The first control in each group usually has the WS_TABSTOP style so that the user can move from group to group. The user can subsequently change the keyboard focus from one control in the group to the next control in the group by using the direction keys.
    /// You can turn this style on and off to change dialog box navigation. To change this style after a window has been created, use the SetWindowLong function.
    /// </summary>
    WS_GROUP = 0x20000,

    /// <summary>The window has a horizontal scroll bar.</summary>
    WS_HSCROLL = 0x100000,

    /// <summary>The window is initially maximized.</summary>
    WS_MAXIMIZE = 0x1000000,

    /// <summary>The window has a maximize button. Cannot be combined with the WS_EX_CONTEXTHELP style. The WS_SYSMENU style must also be specified.</summary>
    WS_MAXIMIZEBOX = 0x10000,

    /// <summary>The window is initially minimized.</summary>
    WS_MINIMIZE = 0x20000000,

    /// <summary>The window has a minimize button. Cannot be combined with the WS_EX_CONTEXTHELP style. The WS_SYSMENU style must also be specified.</summary>
    WS_MINIMIZEBOX = 0x20000,

    /// <summary>The window is an overlapped window. An overlapped window has a title bar and a border.</summary>
    WS_OVERLAPPED = 0x0,

    /// <summary>The window is an overlapped window.</summary>
    WS_OVERLAPPEDWINDOW = WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU | WS_SIZEFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX,

    /// <summary>The window is a pop-up window. This style cannot be used with the WS_CHILD style.</summary>
    WS_POPUP = 0x80000000u,

    /// <summary>The window is a pop-up window. The WS_CAPTION and WS_POPUPWINDOW styles must be combined to make the window menu visible.</summary>
    WS_POPUPWINDOW = WS_POPUP | WS_BORDER | WS_SYSMENU,

    /// <summary>The window has a sizing border.</summary>
    WS_SIZEFRAME = 0x40000,

    /// <summary>The window has a sizing border. Same as the WS_SIZEBOX style.</summary>
    WS_THICKFRAME = 0x00040000,

    /// <summary>The window has a window menu on its title bar. The WS_CAPTION style must also be specified.</summary>
    WS_SYSMENU = 0x80000,

    /// <summary>
    /// The window is a control that can receive the keyboard focus when the user presses the TAB key.
    /// Pressing the TAB key changes the keyboard focus to the next control with the WS_TABSTOP style.  
    /// You can turn this style on and off to change dialog box navigation. To change this style after a window has been created, use the SetWindowLong function.
    /// For user-created windows and modeless dialogs to work with tab stops, alter the message loop to call the IsDialogMessage function.
    /// </summary>
    WS_TABSTOP = 0x10000,

    /// <summary>The window is initially visible. This style can be turned on and off by using the ShowWindow or SetWindowPos function.</summary>
    WS_VISIBLE = 0x10000000,

    /// <summary>The window has a vertical scroll bar.</summary>
    WS_VSCROLL = 0x200000
}

C# Definition:

[Flags]
private enum WindowStyles : uint
{
    WS_BORDER = 0x800000,
    WS_CAPTION = 0xc00000,
    WS_CHILD = 0x40000000,
    WS_CLIPCHILDREN = 0x2000000,
    WS_CLIPSIBLINGS = 0x4000000,
    WS_DISABLED = 0x8000000,
    WS_DLGFRAME = 0x400000,
    WS_GROUP = 0x20000,
    WS_HSCROLL = 0x100000,
    WS_MAXIMIZE = 0x1000000,
    WS_MAXIMIZEBOX = 0x10000,
    WS_MINIMIZE = 0x20000000,
    WS_MINIMIZEBOX = 0x20000,
    WS_OVERLAPPED = 0x0,
    WS_OVERLAPPEDWINDOW = WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU | WS_SIZEFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX,
    WS_POPUP = 0x80000000u,
    WS_POPUPWINDOW = WS_POPUP | WS_BORDER | WS_SYSMENU,
    WS_SIZEFRAME = 0x40000,
    WS_SYSMENU = 0x80000,
    WS_TABSTOP = 0x10000,
    WS_VISIBLE = 0x10000000,
    WS_VSCROLL = 0x200000
}

VB.NET Definition:

''' <summary>
''' Window Styles.
''' The following styles can be specified wherever a window style is required. After the control has been created, these styles cannot be modified, except as noted.
''' </summary>
     <Flags()> Private Enum WindowStyles As UInteger
    ''' <summary>The window has a thin-line border.</summary>
    WS_BORDER = &H800000

    ''' <summary>The window has a title bar (includes the WS_BORDER style).</summary>
    WS_CAPTION = &HC00000

    ''' <summary>The window is a child window. A window with this style cannot have a menu bar. This style cannot be used with the WS_POPUP style.</summary>
    WS_CHILD = &H40000000

    ''' <summary>Excludes the area occupied by child windows when drawing occurs within the parent window. This style is used when creating the parent window.</summary>
    WS_CLIPCHILDREN = &H2000000

    ''' <summary>
    ''' Clips child windows relative to each other; that is, when a particular child window receives a WM_PAINT message, the WS_CLIPSIBLINGS style clips all other overlapping child windows out of the region of the child window to be updated.
    ''' If WS_CLIPSIBLINGS is not specified and child windows overlap, it is possible, when drawing within the client area of a child window, to draw within the client area of a neighboring child window.
    ''' </summary>
    WS_CLIPSIBLINGS = &H4000000

    ''' <summary>The window is initially disabled. A disabled window cannot receive input from the user. To change this after a window has been created, use the EnableWindow function.</summary>
    WS_DISABLED = &H8000000

    ''' <summary>The window has a border of a style typically used with dialog boxes. A window with this style cannot have a title bar.</summary>
    WS_DLGFRAME = &H400000

    ''' <summary>
    ''' The window is the first control of a group of controls. The group consists of this first control and all controls defined after it, up to the next control with the WS_GROUP style.
    ''' The first control in each group usually has the WS_TABSTOP style so that the user can move from group to group. The user can subsequently change the keyboard focus from one control in the group to the next control in the group by using the direction keys.
    ''' You can turn this style on and off to change dialog box navigation. To change this style after a window has been created, use the SetWindowLong function.
    ''' </summary>
    WS_GROUP = &H20000

    ''' <summary>The window has a horizontal scroll bar.</summary>
    WS_HSCROLL = &H100000

    ''' <summary>The window is initially maximized.</summary>
    WS_MAXIMIZE = &H1000000

    ''' <summary>The window has a maximize button. Cannot be combined with the WS_EX_CONTEXTHELP style. The WS_SYSMENU style must also be specified.</summary>
    WS_MAXIMIZEBOX = &H10000

    ''' <summary>The window is initially minimized.</summary>
    WS_MINIMIZE = &H20000000

    ''' <summary>The window has a minimize button. Cannot be combined with the WS_EX_CONTEXTHELP style. The WS_SYSMENU style must also be specified.</summary>
    WS_MINIMIZEBOX = &H20000

    ''' <summary>The window is an overlapped window. An overlapped window has a title bar and a border.</summary>
    WS_OVERLAPPED = &H0

    ''' <summary>The window is an overlapped window.</summary>
    WS_OVERLAPPEDWINDOW = WS_OVERLAPPED Or WS_CAPTION Or WS_SYSMENU Or WS_SIZEFRAME Or WS_MINIMIZEBOX Or WS_MAXIMIZEBOX

    ''' <summary>The window is a pop-up window. This style cannot be used with the WS_CHILD style.</summary>
    WS_POPUP = &H80000000UI

    ''' <summary>The window is a pop-up window. The WS_CAPTION and WS_POPUPWINDOW styles must be combined to make the window menu visible.</summary>
    WS_POPUPWINDOW = WS_POPUP Or WS_BORDER Or WS_SYSMENU

    ''' <summary>The window has a sizing border.</summary>
    WS_SIZEFRAME = &H40000

    ''' <summary>The window has a window menu on its title bar. The WS_CAPTION style must also be specified.</summary>
    WS_SYSMENU = &H80000

    ''' <summary>
    ''' The window is a control that can receive the keyboard focus when the user presses the TAB key.
    ''' Pressing the TAB key changes the keyboard focus to the next control with the WS_TABSTOP style.  
    ''' You can turn this style on and off to change dialog box navigation. To change this style after a window has been created, use the SetWindowLong function.
    ''' For user-created windows and modeless dialogs to work with tab stops, alter the message loop to call the IsDialogMessage function.
    ''' </summary>
    WS_TABSTOP = &H10000

    ''' <summary>The window is initially visible. This style can be turned on and off by using the ShowWindow or SetWindowPos function.</summary>
    WS_VISIBLE = &H10000000

    ''' <summary>The window has a vertical scroll bar.</summary>
    WS_VSCROLL = &H200000
    End Enum

VB Definition

Public Enum WindowStyles
     WS_BORDER As Long = &H800000
     WS_CAPTION As Long = &HC00000
     WS_CHILD As Long = &H40000000
     WS_CLIPCHILDREN As Long = &H2000000
     WS_CLIPSIBLINGS As Long = &H4000000
     WS_DISABLED As Long = &H8000000
     WS_DLGFRAME As Long = &H400000
     WS_GROUP As Long = &H20000
     WS_HSCROLL As Long = &H100000
     WS_MAXIMIZE As Long = &H1000000
     WS_MAXIMIZEBOX As Long = &H10000
     WS_MINIMIZE As Long = &H20000000
     WS_MINIMIZEBOX As Long = &H20000
     WS_OVERLAPPED As Long = &H0
     WS_OVERLAPPEDWINDOW As Long = WS_OVERLAPPED Or WS_CAPTION Or WS_SYSMENU Or WS_SIZEFRAME Or WS_MINIMIZEBOX Or WS_MAXIMIZEBOX
     WS_POPUP As Long = &H80000000UI
     WS_POPUPWINDOW As Long = WS_POPUP Or WS_BORDER Or WS_SYSMENU
     WS_SIZEFRAME As Long = &H40000
     WS_SYSMENU As Long = &H80000
     WS_TABSTOP As Long = &H10000
     WS_VISIBLE As Long = &H10000000
     WS_VSCROLL As Long = &H200000
End Enum    

Notes:

For extended window styles, see WindowStylesEx.

Documentation
 

Please edit this page!

Do you have...

  • helpful tips?
  • corrections to the existing content?
  • additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it!

 
Access PInvoke.net directly from VS:
Terms of Use
Find References
Show Printable Version
Revisions