Manual Message Retrieval

When you want full control on when and where in your application to display a ReachOut message to your users, you can define ReachOut messages of the type plain text or URL. From within the application call one of the below functions to check with the Usage Intelligence server whether there are any pending messages (of this type) waiting to be delivered.

You may choose to display plain text messages anywhere in the application such as in a status bar or information box. URL type messages can either be opened in a browser or else rendered it in a HTML previewer embedded within the application.

The difference between checkForReachOut() and checkForReachOutOfType() is that checkForReachOut() takes an ‘empty’ messageType parameter and fills it with the type of message that is sent by the server. In the case of checkForReachOutOfType(), the message type is specified by the developer and the server would then only send messages of that type.

The message type (plain text or URL) can be one of the types from the following RUIMessageType enum:

ANY  (0)

TEXT (1)

URL  (2)

For more information, see the following:

Checking for Manual ReachOut Messages of Any Type
Checking for Manual ReachOut Messages of a Specified Type