Class: TInputMethodCantUseGUIElementException

Declaration: TextInputMethod.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TStandardException

Inherited By:

None.

Purpose:

Thrown by derived classes of TInputMethodTextPresentation from AdoptAlertWindow, AdoptMenuWindow, AdoptPaletteWindow, and AdoptInputMethodMenuItem if the GUI element cannot be adopted. This might be the case if there is no place to install the requested item. Taligent strongly recommends that you always honor calls to the Adopt functions and that you not throw this exception in your derived class. It is very difficult for an end user to use an input method without additional UI elements.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

This class should not normally be derived.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TInputMethodCantUseGUIElementException::~TInputMethodCantUseGUIElementException

virtual ~ TInputMethodCantUseGUIElementException ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TInputMethodCantUseGUIElementException::TInputMethodCantUseGUIElementException

Interface Category:

API.

Purpose:

Default constructor.
Copy constructor.

Calling Context:

Called by the stream-in operators or to throw the exception.
Called to copy an object.

Parameters:

Takes no parameters.
const TInputMethodCantUseGUIElementException & -the exception to copy.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TInputMethodCantUseGUIElementException::operator=

TInputMethodCantUseGUIElementException & operator =(const TInputMethodCantUseGUIElementException &)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const TInputMethodCantUseGUIElementException & -The object to copy.

Return Value:

A reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TInputMethodCantUseGUIElementException::Throw

virtual void Throw () const

Interface Category:

API.

Purpose:

Throws the exception.

Calling Context:

Usually used only when exception is streamed or otherwise passed polymorphically.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws *this

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.