Rockwell Automation 2706-P42_P43_P44_P72_P74_P92_P94 InView Marquee Message Display User Manual User Manual

Page 128

Advertising
background image

Publication 2706-UM016D-EN-P - March 2006

5-10 InView Control and InView Control API

DownloadMessage

Description

This method is used to download a simple
message to the display. The download
message command will be sent to the
display address set by the DisplayAddress
property. DisplayAddress should be set
before calling this method.

DownloadMessageEx

Syntax

HRESULT DownloadMessageEx
(BSTR bstrMessage)

Parameters

bstrMessage
A complete InView protocol formatted
download message string.

Return Value

S_OK - Success
E_FAIL - Failure

Description

This method is for advanced users only and
requires knowledge of the InView Protocol.
It allows you to download a message of any
complexity to the display. The download
message command will be sent to the
display address set by the DisplayAddress
property. DisplayAddress should be set
before calling this method.

AddMessage

Syntax

HRESULT AddMessage
(short nMessageNumber)

Parameters

nMessageNumber
The number of the message to be added to
the queue of running messages.

Return Value

S_OK - Success
E_FAIL - Failure

Description

This method is used to trigger a message to
run on the display. A message of lower
priority will not be visible if a higher priority
message is running. The message to trigger
must be downloaded to the display before it
can be triggered. The maximum number of
messages that can be queued to run is 60.
The add message command will be sent to
the display address set by the
DisplayAddress property. DisplayAddress
should be set before calling this method.

Methods

InViewCtrl Methods

Properties

Description

Advertising