RaiseEventByName

Raises an event by name on an object, with the event arguments supplied as a Variant array. RaiseEventByName is a twinBASIC addition; the equivalent at compile time is the RaiseEvent statement, which requires the event name to be known when the code is written.

Syntax: RaiseEventByName( object , procname [ , argsarray ] )

object
required Object. The object on which to raise the event. The object must declare a public event with the matching procname and an arity matching the number of items in argsarray.
procname
required String. The name of the event to raise.
argsarray
optional Variant. A one-dimensional array containing the arguments to pass to the event handler(s), in declaration order. Pass an uninitialized Variant for an event that takes no parameters.

Returns a Variant. The returned value is the value left in the last ByRef event argument by the handler — useful only when the event has a ByRef “out” or “cancel” parameter.

Note

The variable-length-argument variant of this function — RaiseEventByName2 — accepts arguments directly via ParamArray, which is usually more readable when the event signature is fixed. Use RaiseEventByName when the argument list is itself constructed dynamically.

If procname doesn’t match any event declared on object, or the supplied arity doesn’t match the event declaration, a run-time error occurs.

Note BETA 1034

An event that no handler is attached to raises error -2147467259 (&H80004005), Unspecified error. The RaiseEvent statement raises nothing for it.

Common Errors

Error When
91 (&H5B), Object variable or With block variable not set object is Nothing

Example 

Dim MyControl As Object
Dim Args(0) As Variant
Args(0) = "Some argument value"
RaiseEventByName MyControl, "ValueChanged", Args

See Also