annotate foosdk/sdk/libPPUI/hookWindowMessages.h @ 1:20d02a178406 default tip

*: check in everything else yay
author Paper <paper@tflc.us>
date Mon, 05 Jan 2026 02:15:46 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
1 #pragma once
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
2
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
3 #include "windowLifetime.h"
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
4
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
5 namespace PP {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
6 // CContainedWindow replacement
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
7 // Rationale:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
8 // With CContainedWindow, all messages that the window gets are routed through the message map of your class.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
9 // The window might bounce some of the messages to other windows (say, mouse4/5 handlers, WM_CONTEXTMENU), or do modal loops.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
10 // If some events triggered by those destroy your CContainedWindow host, crash happens, because your object is still on stack.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
11 // hookWindowMessages() sends only the messages you ask for to your class, also managing hook lifetime behind the scenes.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
12 void hookWindowMessages(HWND wnd, CMessageMap* target, DWORD targetID, std::initializer_list<DWORD>&& msgs);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
13
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
14 typedef std::function<bool(HWND, UINT, WPARAM, LPARAM, LRESULT&) > messageHook_t;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
15 void hookWindowMessages(HWND wnd, messageHook_t h);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
16 }