![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
None.
Inherited By:
None.
Purpose:
A concrete class whose sole purpose is to identify input devices (TEventSenders) across tasks. TEventSenderSurrogate objects are lightweight and provide a simple protocol for validity and for identity comparison to other surrogates or to TEventSenders. TEventSenderSurrogates maintain an identifier that is used to determine both validity and identity.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
None.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
- TEventSenderSurrogate ()
- TEventSenderSurrogate (const TEventSender & original)
- TEventSenderSurrogate (const TEventSenderSurrogate & copy)
Interface Category:
API.
Purpose:
- Default constructor. This constructor creates an invalid event sender surrogate.
- Creates a valid event sender surrogate that is the surrogate for the specified event sender.
- Copy constructor.
Calling Context:
- Called by the stream-in operators.
- Call this function directly.
- Called to copy an object.
Parameters:
- Takes no parameters.
- const TEventSender & original -The event sender for which the new object is a surrogate.
- const TEventSenderSurrogate & copy -The object to be copied.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TEventSenderSurrogate ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Called to destroy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
TEventSenderSurrogate & operator =(const TEventSenderSurrogate & assign)
Interface Category:
API.
Purpose:
Assignment operator.
Calling Context:
Call this function by using the operator in an assignment statement.
Parameters:
Return Value:
Returns a const reference to the left-hand side object.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
bool operator ==(const TEventSenderSurrogate & other) const
Interface Category:
API.
Purpose:
Determines whether this event sender surrogate and the one specified are equal to one another. Valid surrogates are equal if and only if their identifiers are equal. Invalid surrogates are all equal to each other.
Calling Context:
Call this function by using the operator in an expression.
Parameters:
Return Value:
Returns true if the two objects are equal; false otherwise.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
bool operator != (const TEventSenderSurrogate & other) const
Interface Category:
API.
Purpose:
Determines whether this event sender surrogate and the one specified are not equal to one another. Valid surrogates are equal if and only if their identifiers are equal. Invalid surrogates are all equal to each other.
Calling Context:
Call this function by using the operator in an expression.
Parameters:
Return Value:
Returns true if the two objects are not equal; false otherwise.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual EComparisonResult Compare (const TEventSenderSurrogate & other) const
Interface Category:
API.
Purpose:
Compares this event sender surrogate object with the specified TEventSenderSurrogate object. Valid surrogates are equal if and only if their identifiers are equal. Invalid surrogates are all equal to each other.
Calling Context:
Call this function directly.
Parameters:
Return Value:
Returns kEqual if the objects are equal, or kNotEqual if the objects are not equal.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual HashResult GetHash () const
Interface Category:
API.
Purpose:
Returns the hash value that uniquely identifies this object within its type. Hash values are used to build dictionaries of objects.
Calling Context:
Call this function directly.
Parameters:
Return Value:
Returns the hash value that uniquely identifies this object within its type.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual TStream & operator >>=(TStream & writeTo) const
Interface Category:
API.
Purpose:
Stream-out operator.
Calling Context:
Called to stream out data.
Parameters:
- TStream & writeTo -The stream to which the object streams itself out.
Return Value:
Returns a reference to the stream the object streams itself out to.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual TStream & operator <<= (TStream & readFrom)
Interface Category:
API.
Purpose:
Stream-in operator.
Calling Context:
Called to stream in data.
Parameters:
- TStream & readFrom -The stream from which the object streams itself in.
Return Value:
Returns a reference to the stream the object streams itself in from.
Exceptions:
Throws a TInvalidVersionError if the version of the object on the stream is unknown to the version of the shared library that is installed.
Concurrency:
Not multithread safe.
Other Considerations:
None.
bool IsValid () const
Interface Category:
API.
Purpose:
Determines whether this event sender surrogate is valid. A valid TEventSenderSurrogate represents an input device (TEventSender) that has been registered with the Input system.
Calling Context:
Call this function directly.
Parameters:
Return Value:
Returns true if this event sender surrogate is valid; otherwise, returns false.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.