Exception handling classes

Classes
class	owl::TXInvalidMainWindow
class	owl::TXClipboard
	TXClipboard creates the TXClipboard exception with a string resource. More...
class	owl::TXBase
class	owl::TXOwl
	TXOwl is root class of the ObjectWindows exception hierarchy. More...
class	owl::TXOutOfMemory
	Describes an exception that results from running out of memory. More...
class	owl::TXNotSupportedCall
class	owl::TXEndSession
class	owl::TXGdi
Functions
	owl::TXOwl::TXOwl (uint resId, TModule *module=&GetGlobalModule())
virtual	owl::TXOwl::~TXOwl () throw ()
void	owl::TXOwl::Throw ()
virtual int	owl::TXOwl::Unhandled (TModule *appModule, uint promptResId)
uint	owl::TXOwl::GetErrorCode () const
static tstring	owl::TXOwl::ResourceIdToString (bool *found, uint resId, TModule *module=&GetGlobalModule())
static tstring	owl::TXOwl::MakeMessage (uint resId, const tstring &infoStr, TModule *module=&GetGlobalModule())
static tstring	owl::TXOwl::MakeMessage (uint resId, LPCTSTR infoStr, TModule *module=&GetGlobalModule())
static tstring	owl::TXOwl::MakeMessage (uint resId, uint infoNum, TModule *module=&GetGlobalModule())
static void	owl::TXOwl::Raise (const tstring &msg, uint resId=0)
static void	owl::TXOwl::Raise (uint resId, TModule *module=&GetGlobalModule())
void	owl::TXOutOfMemory::Throw ()
static void	owl::TXOutOfMemory::Raise ()
void	owl::TXNotSupportedCall::Throw ()
static void	owl::TXNotSupportedCall::Raise ()
Variables
uint	owl::TXOwl::ResId

---

Detailed Description

Exception handling classes provide various functions that help you write error-free ObjectWindows applications. TXBase is the base class for all ObjectWindows and ObjectComponents classes. Derived from the TXBase class, TXOwl is the base class for the following ObjectWindows exception classes:

• TXCompatibility is included for backward compatibility with ObjectWindows 1.0 code.
• TXOutOfMemory describes exceptions that arise from out of memory conditions.
• Exception classes such as TXInvalidMainWindow, TXInvalidModule, TXWIndow, TXMenu, TXValidator, TXGdi, and TXPrinter describe specific error conditions such as those that occur when a main window, a module, a menu object, a validator object, a GDI object, or a printer device context is invalid.

---

Function Documentation

owl::TXOwl::TXOwl	(	uint	resId,
		TModule *	module = &GetGlobalModule()
	)

An OWL exception with a given unsigned Id that can is used for loading a message string & identification Loads the string resource identified by the resId parameter and uses this resId to initialize the TXBase object.

owl::TXOwl::~TXOwl

(

)

throw () [virtual]

Destroys a TXOwl object.

uint owl::TXOwl::GetErrorCode

(

)

const [inline]

Returns the resource ID.

References owl::TXOwl::ResId.

tstring owl::TXOwl::MakeMessage	(	uint	resId,
		LPCTSTR	infoStr,
		TModule *	module = &GetGlobalModule()
	)		[static]

Extension to string loader adds the feature of sprintf'ing an additional information string into the resource message string.

References owl::TXOwl::ResourceIdToString().

tstring owl::TXOwl::MakeMessage	(	uint	resId,
		uint	infoNum,
		TModule *	module = &GetGlobalModule()
	)		[static]

This extension to the string loader adds the feature of sprintf'ing an additional information string into the resource message string.

References owl::TXOwl::ResourceIdToString().

void owl::TXOutOfMemory::Raise

(

)

[static]

Construct a TXOutOfMemory exception from scratch, and throw it.

References owl::TXOutOfMemory::TXOutOfMemory().

tstring owl::TXOwl::ResourceIdToString	(	bool *	found,
		uint	resId,
		TModule *	module = &GetGlobalModule()
	)		[static]

Static member function used to convert a resource id to a 'string'. This is necessary since we must pass a string to the xmsg base class constructor. Sets found to true if the resource was located, otherwise false. In either case, the string is initialized to something printable. If the string message cannot be loaded, returns a "not found" message.

References owl::TModule::LoadString().

void owl::TXNotSupportedCall::Throw

(

)

[virtual]

Throws the exception object. Throw must be implemented in any class derived from TXOwl.

Reimplemented from owl::TXOwl.

void owl::TXOwl::Throw

(

)

[virtual]

Throws the exception object. Throw must be implemented in any class derived from TXOwl.

Reimplemented from owl::TXBase.

Reimplemented in owl::TXInvalidMainWindow, owl::TXClipboard, owl::TXCommCtrl, owl::TXOutOfMemory, owl::TXNotSupportedCall, owl::TXBadFormat, owl::TXGdi, owl::TXMenu, owl::TXInvalidModule, owl::TXModuleVersionInfo, owl::TXPrinter, owl::TXPrinting, owl::TXShell, owl::TXTheme, owl::TXValidator, and owl::TXWindow.

void owl::TXOutOfMemory::Throw

(

)

[virtual]

Throws the exception object. Throw must be implemented in any class derived from TXOwl.

Reimplemented from owl::TXOwl.

int owl::TXOwl::Unhandled	(	TModule *	appModule,
		uint	promptResId
	)		[virtual]

Called when an unhandled exception is caught at the main message loop level.

Per-exception class unhandled-handler, will default to the per-module unhandled-handler

Reimplemented in owl::TXWindow.

---

Variable Documentation

uint owl::TXOwl::ResId

Resource ID for a TXOwl object.