RedrawWindowFlags Enumeration

Specifies how a window must be redrawn by RedrawWindow(IntPtr, NativeRectangle, IntPtr, RedrawWindowFlags) function.

Definition

Namespace: DevCase.Win32.Enums
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[FlagsAttribute]
public enum RedrawWindowFlags

Remarks

Members

Invalidate 1 Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate parameters.

You can set only one of these parameters to a non-Zero value. If both are Zero, Invalidate invalidates the entire window.

InternalPaint 2 Causes the OS to post a WM_Paint message to the window regardless of whether a portion of the window is invalid.
Erase 4 Causes the window to receive a WM_EraseBkgnd message when the window is repainted.

Specify this value in combination with the Invalidate value; otherwise, Erase has no effect.

Validate 8 Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate parameters.

You can set only one of these parameters to a non-Zero value. If both are Zero, Validate validates the entire window.

This value does not affect internal WM_Paint messages.

NoInternalPaint 16 Suppresses any pending internal WM_Paint messages.

This flag does not affect WM_Paint messages resulting from a non-NULL update area.

NoErase 32 Suppresses any pending WM_EraseBkgnd messages.
NoChildren 64 Excludes child windows, if any, from the repainting operation.
AllChildren 128 Includes child windows, if any, in the repainting operation.
UpdateNow 256 Causes the affected windows, which you specify by setting the AllChildren and NoChildren values, to receive WM_EraseBkgnd and WM_Paint messages before the RedrawWindow returns, if necessary.
EraseNow 512 Causes the affected windows, which you specify by setting the AllChildren and NoChildren values, to receive WM_EraseBkgnd messages before RedrawWindow(IntPtr, NativeRectangle, IntPtr, RedrawWindowFlags) returns, if necessary.

The affected windows receive WM_Paint messages at the ordinary time.

Frame 1,024 Causes any part of the non-client area of the window that intersects the update region to receive a WM_NcPaint message.

The Invalidate flag must also be specified; otherwise, Frame has no effect.

The WM_NcPaint message is typically not sent during the execution of RedrawWindow(IntPtr, NativeRectangle, IntPtr, RedrawWindowFlags) unless either UpdateNow or EraseNow is specified.

NoFrame 2,048 Suppresses any pending WM_NcPaint messages.

This flag must be used with Validate and is typically used with NoChildren.

NoFrame should be used with care, as it could cause parts of a window to be painted improperly.

See Also