Window Classes

Window Classes

Window Classes

Thistopic describes the types of window classes, how the system locatesthem, and the elements that define the default behavior of windows thatbelong to them.

A window class is a set of attributes that thesystem uses as a template to create a window. Every window is a memberof a window class. All window classes are process specific.

Overviews

About Window Classes

Each window class has an associated window procedure shared by allwindows of the same class. The window procedure processes messages forall windows of that class and therefore controls their behavior andappearance.

Using Window Classes

This topic has a code example that shows how to register a local window and use it to create a main window.

Functions

GetClassInfo

The GetClassInfo function retrieves information about a window class.

Note  The GetClassInfo function has been superseded by the GetClassInfoEx function. You can still use GetClassInfo, however, if you do not need information about the class small icon.

GetClassInfoEx

The GetClassInfoExfunction retrieves information about a window class, including a handleto the small icon associated with the window class. The GetClassInfo function does not retrieve a handle to the small icon.

GetClassLong

The GetClassLong function retrieves the specified 32-bit (long) value from the WNDCLASSEX structure associated with the specified window.

GetClassLongPtr

The GetClassLongPtr function retrieves the specified value from the WNDCLASSEX structure associated with the specified window.

If you are retrieving a pointer or a handle, this function supersedes the GetClassLongfunction. (Pointers and handles are 32 bits on 32-bit Windows and 64bits on 64-bit Windows.) To write code that is compatible with both32-bit and 64-bit versions of Windows, use GetClassLongPtr.

GetClassName

The GetClassName function retrieves the name of the class to which the specified window belongs.

GetClassWord

The GetClassWord function retrieves the 16-bit (WORD) value at the specified offset into the extra class memory for the window class to which the specified window belongs.

Note  This function is deprecated for any use other than nIndex set to GCW_ATOM. The function is provided only for compatibility with 16-bit versions of Windows. Applications should use the GetClassLong function.

GetWindowLong

The GetWindowLong function retrieves information about the specified window. The function also retrieves the 32-bit (long) value at the specified offset into the extra window memory.

If you are retrieving a pointer or a handle, this function has been superseded by the GetWindowLongPtrfunction. (Pointers and handles are 32 bits on 32-bit Windows and 64bits on 64-bit Windows.) To write code that is compatible with both32-bit and 64-bit versions of Windows, use GetWindowLongPtr.

GetWindowLongPtr

The GetWindowLongPtrfunction retrieves information about the specified window. The functionalso retrieves the value at a specified offset into the extra windowmemory.

If you are retrieving a pointer or a handle, this function supersedes the GetWindowLongfunction. (Pointers and handles are 32 bits on 32-bit Windows and 64bits on 64-bit Windows.) To write code that is compatible with both32-bit and 64-bit versions of Windows, use GetWindowLongPtr.

RegisterClass

The RegisterClass function registers a window class for subsequent use in calls to the CreateWindow or CreateWindowEx function.

The RegisterClass function has been superseded by the RegisterClassEx function. You can still use RegisterClass, however, if you do not need to set the class small icon.

RegisterClassEx

The RegisterClassEx function registers a window class for subsequent use in calls to the CreateWindow or CreateWindowEx function.

SetClassLong

The SetClassLong function replaces the specified 32-bit (long) value at the specified offset into the extra class memory or the WNDCLASSEX structure for the class to which the specified window belongs.

Note  This function has been superseded by the SetClassLongPtr function. To write code that is compatible with both 32-bit and 64-bit versions of Windows, use SetClassLongPtr.

SetClassLongPtr

The SetClassLongPtr function replaces the specified value at the specified offset in the extra class memory or the WNDCLASSEX structure for the class to which the specified window belongs.

This function supersedes the SetClassLong function. To write code that is compatible with both 32-bit and 64-bit Windows, use SetClassLongPtr.

SetClassWord

The SetClassWord function replaces the 16-bit (WORD) value at the specified offset into the extra class memory for the window class to which the specified window belongs.

Note  This function is provided only for compatibility with 16-bit versions of Windows. Applications should use the SetClassLong function.

SetWindowLong

The SetWindowLongfunction changes an attribute of the specified window. The functionalso sets the 32-bit (long) value at the specified offset into theextra window memory.

Note  This function has been superseded by the SetWindowLongPtr function. To write code that is compatible with both 32-bit and 64-bit versions of Windows, use the SetWindowLongPtr function.

SetWindowLongPtr

The SetWindowLongPtrfunction changes an attribute of the specified window. The functionalso sets a value at the specified offset in the extra window memory.

This function supersedes the SetWindowLong function. To write code that is compatible with both 32-bit and 64-bit versions of Windows, use SetWindowLongPtr.

UnregisterClass

The UnregisterClass function unregisters a window class, freeing the memory required for the class.

Structures

WNDCLASS

The WNDCLASS structure contains the window class attributes that are registered by the RegisterClass function.

This structure has been superseded by the WNDCLASSEX structure used with the RegisterClassEx function. You can still use WNDCLASS and RegisterClass if you do not need to set the small icon associated with the window class.

WNDCLASSEX

The WNDCLASSEX structure contains window class information. It is used with the RegisterClassEx and GetClassInfoEx