WNDOBJCHANGEPROC function

The WNDOBJCHANGEPROC function is a driver-defined callback function that GDI uses to notify the driver of changes to the window in question.

Syntax


VOID (*WNDOBJCHANGEPROC)(
   WNDOBJ *pwo,
   FLONG  fl
);

Parameters

pwo

Pointer to a WNDOBJ structure defining the window object that is currently changing. The window object contains the new size and position of the window. If fl is WOC_CHANGED, this parameter is NULL.

fl

Is a flag that describes the change occurring to the window object. This parameter can be one of the following values:

WOC_RGN_CLIENT_DELTA

The WNDOBJ contains a delta client region. The delta region is valid for this call only.

WOC_RGN_CLIENT

The WNDOBJ contains a new client region.

WOC_RGN_SURFACE_DELTA

The WNDOBJ contains a delta surface region. The pvConsumer member of the WNDOBJ structure is zero. The delta region is valid for this call only.

WOC_RGN_SURFACE

The WNDOBJ refers to a surface region created by GDI. The pvConsumer member of the WNDOBJ structure is zero.

WOC_CHANGED

All windows have been updated. GDI always notifies the driver at the end of a desktop update.

WOC_DELETE

The WNDOBJ is being deleted as a result of the deletion of the window.

WOC_DRAWN

The windows subsystem has completed the screen-to-screen blit calls (screen-to-screen DrvCopyBits) necessary to update the screen contents to correspond with the window region changes.

WOC_SPRITE_OVERLAP

A sprite overlaps with the WNDOBJ area. This parameter is used when a sprite is first moved on top of the WNDOBJ area or immediately after the WNDOBJ is created if it overlaps with a preexisting sprite.

WOC_SPRITE_NO_OVERLAP

Sprites no longer overlap the WNDOBJ area. This parameter is used when all sprites have been moved off the WNDOBJ area, and will be used only if the callback was previously called with WOC_SPRITE_OVERLAP.

Return value

None

Remarks

The pfn parameter of the EngCreateWnd function points to this function.

Requirements

Target platform

Desktop

Header

Winddi.h (include Winddi.h)

See also

EngCreateWnd
WNDOBJ
DrvCopyBits

 

 

Send comments about this topic to Microsoft

Show: