Introduction

The TdvResultPanel offers an easy way to display measurement results on a different computer than the one that calculates the results. The values to display are set by sending commands to TdvResultPanel through TCP/IP.

The TdvResultPanel is a part of the TORDIVEL SOFTWARE SOLUTIONS.

TdvResultPanel is copyright of TORDIVEL AS 2002.

16 April 2002, Oslo, Norway.

Help Index

•	Using the program

•	Protocol description

•	Command line interface


Protocol description

Command	Request	Response
Show	Show; Value=<Hide|Normal|Status>	ShowResponse; Status=<Visible|Hidden>
VersionInformation	GetVersion	GetVersionResponse; Version=<Version_str>
GetValue	GetValue; Value=<Caption>	GetValueResponse; <Caption>=<value|error>
SetValue	SetValue; <Caption>=<Value>	SetValueResponse; <Caption>=<ok|error>
GetTagColor	GetTagColor; Value=<Caption>	GetTagColorResponse; <Caption>=<Color>
SetTagColor	SetTagColor; <Caption>=<Color>	SetTagColorResponse; <Caption>=<ok|error>


The Get/SetTagColor commands

The format of the commands are:

•	GetTagColor:	GetTagColor;Value=<Caption>

•	SetTagColor:	SetTagColor;<Caption>=<Color>

Example:

•	GetTagColor;Value=MaxGap

•	SetTagColor;MaxGap=Green

The defined colors are:

•	Aqua

•	Black

•	Blue

•	Cream

•	Fuchsia

•	Gray

•	Green

•	Lime

•	MedGray

•	Navy

•	Olive

•	Purple

•	Red

•	Silver

•	SkyBlue

•	Teal

•	White

•	Yellow


Using the program

The appearance of the panel is user configurable. Below is an example of how the panel can look.

The tag colors can only be set from the external source, through the SetTagColor command.


Command Line Interface

The program can be started from the command line with the name of the configuration file as a parameter. If the filename is missing a warning is issued, and the file must be entered manually. If the user wants to start the program hidden, ”-hide” can be passed as a second parameter.

The syntax is

•	>TdvResultPanel.exe .\<filename>.spb -hide


Configuration

In addition to the General tab, the configuration consists of:

•	Values configuration

•	Buttons configuration

•	Communication

•	About

When the Enable title checkbox is ticked the title entered in the corresponding edit field appears on top of the panel. The same applies for the Enable window title checkbox.

If the Enable window title is not ticked the panel has no border, and the system menu disappears. The configuration, about box and help file can only be accessed by right clicking in the panel.


Values configuration

When the user configures the panel he can decide:

•	How many lines the panel should contain

•	The positions of the captions and values

•	Fonts and colors of the title, lines and background

•	Value of captions and dimensions

•	Which format strings to use in order to get the displayed value the way he wants


Values – Captions and Dimensions

On this page the captions and dimensions are configured.

The Captions -Dimensions list contains the values of the line’s captions and dimensions. The order in the list is the same as the order the lines appear in the panel.


Values – Format strings

The list contains the format strings of the list’s values. When a SetValue request is received the value is displayed according to the corresponding format string.


Buttons configuration

When the user configures the buttons he can decide:

•	How many buttons the panel should contain

•	The positions of the buttons

•	The buttons’ fonts and sizes

•	The buttons’ captions and commands


Buttons – Captions and Commands

The list contains the values of the buttons’ captions and commands. The order in the list is the same as the order the buttons appear in the panel.

The list contains the commands which are sent through TCP/IP when the corresponding buttons are pressed. If the command is prefixed with “destination=<ip-address>:<port>:” the command is sent to this IP-address and port. Otherwise it is sent to the IP-address and port entered in the Remote field on the Communication tab.


Communication

The TCP/IP communication must be configured as shown below. Commands that are sent and received are shown in the log. Ticking the Activate TCP/IP communication checkbox opens the port.


About

Pressing the Licence information button brings up the application’s licence settings.


Licence information


Positions


Button Positions


TORDIVEL SOFTWARE SOLUTIONS

TORDIVEL AS Software House is developing a portfolio of Windows NT/2000 software components and solutions with the following properties:

•	Simple and easy to use

•	Very high quality

•	Requirements from real use cases

•	Easy to deploy

•	"Simply working"

•	Network applications building blocks

Important keywords are: HTTP, TCP/IP, XML, and stateless servers.

These components and solutions are divided into two categories:

•	Professional Software Components

•	Freeware Components Library

We distribute the components and solutions to promote the skills of the experienced developers working at TORDIVEL and want to establish links to developers and companies all over the world.

If you have comments/suggestions your feedback is more than appreciated. Please contact us.

Storgata 20 N-0184 OSLO NORWAY
Telefax +47 2315 8701 Telephone +47 2315 8700
E-mail: office@tordivel.com Web: http://www.tordivel.com


Copyright Notice

(c) 2002 TdvResultPanel is copyright of

Storgata 20 N-0184 OSLO NORWAY
Telefax +47 2315 8701 Telephone +47 2315 8700
E-mail: office@tordivel.com Web: http://www.tordivel.com