Blam::Dialogs Namespace Reference

Namespace containing things related to the displaying of Win32 dialogs. More...

Functions
BLAM void	FirstbootDialogProcedure (HINSTANCE hInst, HWND hWnd)
	Dialog procedure for the Firstboot dialog. More...
BLAM void	AboutDialogProcedure (HINSTANCE hInst, HWND hWnd)
	Dialog procedure for the About dialog. More...
BLAM void	EngineInformationDialogProcedure (HINSTANCE hInst, HWND hWnd)
	Dialog procedure for the Engine Information dialog. More...
BLAM void	ErrorDialogProcedure (HINSTANCE hInst, HWND hWnd, LPSTR error_text)
	Dialog procedure for the Error dialog. More...
BLAM void	FontTestDialogProcedure (HINSTANCE hInst, HWND hWnd)
	Dialog procedure for the Font Test dialog. More...
BLAM int	ErrorDialogModal (HINSTANCE hInst, HWND hWnd, LPSTR error_text, bool allow_continue, bool allow_safemode)
	Displays the Error dialog as a modal dialog - in other words, it halts engine execution. More...
BLAM void	SentryEventIdDialogProcedure (HINSTANCE instance_handle, HWND window_handle)

Detailed Description

Namespace containing things related to the displaying of Win32 dialogs.

Function Documentation

AboutDialogProcedure()

void Blam::Dialogs::AboutDialogProcedure	(	HINSTANCE	hInst,
		HWND	hWnd
	)

Dialog procedure for the About dialog.

The about dialog will show...something. Right now, its just a copy/paste from when I was angry and had no idea how to make dialogs work. As such, it still identifies itself as FUCKING_DIALOG_TEST rather than Blamite. It also has a button to view engine information.

Parameters

hInst	- The instance handle of the application.
hWnd	- The window handle to act as the parent window.

EngineInformationDialogProcedure()

void Blam::Dialogs::EngineInformationDialogProcedure	(	HINSTANCE	hInst,
		HWND	hWnd
	)

Dialog procedure for the Engine Information dialog.

This dialog shows some basic information about this engine build. That's about it. Nothing too crazy.

Parameters

hInst	- The instance handle of the application.
hWnd	- The window handle to act as the parent window.

ErrorDialogModal()

int Blam::Dialogs::ErrorDialogModal	(	HINSTANCE	hInst,
		HWND	hWnd,
		LPSTR	error_text,
		bool	allow_continue,
		bool	allow_safemode
	)

Displays the Error dialog as a modal dialog - in other words, it halts engine execution.

This is probably the ONLY way the Error dialog should ever be used. Its layout borrows heavily from that of Halo CE. In fact, one may notice more than few similarities.

Parameters

hInst	- The instance handle of the application.
hWnd	- The window handle to act as the parent window.
error_text	- The text to show in the Error dialog.
allow_continue	- Whether or not to allow the user to choose the Continue option.
allow_safemode	- Whether or not to allow the user to choose the Safe Mode option.

ErrorDialogProcedure()

void Blam::Dialogs::ErrorDialogProcedure	(	HINSTANCE	hInst,
		HWND	hWnd,
		LPSTR	error_text
	)

Dialog procedure for the Error dialog.

This dialog shows error information, along with machine information. I may have borrowed some layouts from Halo CE - don't tell Microsoft or Bungie xd

Parameters

hInst	- The instance handle of the application.
hWnd	- The window handle to act as the parent window.
error_text	- The text to show in the Error dialog.

FirstbootDialogProcedure()

void Blam::Dialogs::FirstbootDialogProcedure	(	HINSTANCE	hInst,
		HWND	hWnd
	)

Dialog procedure for the Firstboot dialog.

The firstboot dialog should be shown upon first booting a development build of the engine. It will show a message informing developers to report any bugs they find on Gitlab, as well as ask any non-developers to notify Elaztek in the event the build is leaked somehow.

Parameters

hInst	- The instance handle of the application.
hWnd	- The window handle to act as the parent window.

FontTestDialogProcedure()

void Blam::Dialogs::FontTestDialogProcedure	(	HINSTANCE	hInst,
		HWND	hWnd
	)

Dialog procedure for the Font Test dialog.

This dialog allows for testing of Font rendering. Unlike C#, this is Win32 where we have support for real bitmap fonts motherfuckers. It's not really useful outside of just messing around with layouts, but hey - it's a feature.

Parameters

hInst	- The instance handle of the application.
hWnd	- The window handle to act as the parent window.

SentryEventIdDialogProcedure()

void Blam::Dialogs::SentryEventIdDialogProcedure	(	HINSTANCE	instance_handle,
		HWND	window_handle
	)