API Documentation

BInvoker

BInvoker

BInvoker is a convenience class that bundles up everything you need to create a handy message-sending package.

The BInvoker contains:

  • a BMessage

  • a BMessenger (that identifies a target handler), and

  • an optional BHandler that handles replies.

You set these ingredients, invoke Invoke(), and off goes the message to the target. Replies are sent to the reply handler (be_app by default).

BInvoker uses BMessenger::SendMessage() to send its messages. The invocation is asynchronous, and there’s no time limit on the reply.

BInvoker is mostly used as a mix-in class. A number of classes in the Interface Kit notably BControl derive from BInvoker.