Applications often need a way to send a message to end users. The typical approach is to store information somewhere where each station monitors this location. While this “pull” method is useful for offline systems, a “push” method is far better when online systems need an immediate notification. The SRP DirectConnect Control makes this a reality for OpenInsight applications.
 | |
|---|---|
| Prog ID | SRP.DirectConnect.1 |
| Current Version | 1.0.2 |
Properties
OLE control properties are the primary means of interacting with OLE controls. Properties, much like OI control properties, describe the persistent attributes of the control, that is, attributes having some meaningful value for the entire life of the control. The following properties apply to the SRP DirectConnect Control:
| Property | Description | Version Introduced | Pro Version Introduced |
|---|---|---|---|
| Server | The format is IP:@FM:Port. Use this to set the IP and Port number the server is listening on (default port is 779). | ||
| ServerValid Read Only | Use this to test that you have a valid connection. |
Methods
OLE control methods provide convenient one-time operations to developers. Unlike properties, whose values are persistant over the life of a control, methods represent actions that a control can perform. The following methods apply to the SRP DirectConnect Control:
| Method | Description | Version Introduced | Pro Version Introduced |
|---|---|---|---|
| Broadcast(Message) | Call this to send a message to the direct connect server, which copies the message to all other connected direct connect controls. The other controls will receive the OnMessage events with this message. The message can be anything you want. If you want to pass delimited data, avoid using @RM and @FM because OpenInsight doesn’t support those delimeters when passed as event parameters. |
Events
OLE control events provide a way for the OLE control to communicate back to OpenInsight. Once an event has been qualified using OI's QUALIFY_EVENT message, then the OLE control will fire the event to OpenInsight allowing you to respond to any one of the control's predefined actions. The following events apply to the SRP DirectConnect Control:
| Event | Description | Version Introduced | Pro Version Introduced |
|---|---|---|---|
| OnMessage(Message) | Fired when the control receives a message broadcast from another control. The message parameter contains the message. Note: The OnMessage event should be qualified as asynchronous. This is how OpenInsight qualifies OLE events by default. But SRP FrameWorks normally qualifies events as synchronous instead. Therefore there should be a change in the PROMOTED_CREATE_EVENT routine to override this. |
Search this documentation
Popular Topics
No labels match these criteria.
Featured Pages
There is no content with the specified labels
