win32

Anonymous (anonymous@undisclosed.example.com) — 2023-05-28T17:23:50+00:00

Windows Programming Snippets

This is a collection of useful Windows programming snippets we've used throughout the years on various projects. There are also some useful snippets in the Porting to Microsoft Visual C++ page, although those will be related to cross-platform development.

Windows and Controls

Windows are everything in Windows, even controls, some of the Win32 API functions to deal with this core component of the operating system are sometimes laughable, so we need to create our own wrappers to make them useful.

Getting a Window's Text

Such a simple operation should've been so simple and straightforward, after all it's something that you'll be doing a lot in Windows, but the people that designed the API didn't think about including a little helper to make this task easier.

/**
 * Gets a window's text property into a newly allocated buffer. No need for
 * pointer wrangling.
 *
 * @warning This function allocates memory that must be free'd by you.
 * 
 * @param hWnd Handle of the window we want the text from.
 * 
 * @return Newly allocated buffer with the window's text.
 */
LPTSTR GetWindowTextAlloc(HWND hWnd) {
	int iLen;
	LPTSTR szText;
 
	/* Get the length of the text. */
	iLen = GetWindowTextLength(hWnd) + 1;
 
	/* Allocate the memory to receive the window's text. */
	szText = (LPTSTR)malloc(iLen * sizeof(TCHAR));
	if (szText == NULL)
		return NULL;
 
	/* Get the text from the window. */
	GetWindowText(hWnd, szText, iLen);
 
	return szText;
}

Dialogs

Dialogs are almost the heart of every Windows application, so there are a lot of repetitive things that we usually want to do with them.

Centering on a Parent Window

Whenever we are opening a new dialog, commonly, we want it to open in the center of the dialog's parent window. This is so common that Microsoft has even documented it.