AppendPointLabelData

Scope	Graph Object.
Type	Property Array of type String
Default	empty
Custom	NA
Ocx\|Vcl	NA
DLL	PEP_szaAPPENDPOINTLABELDATA

Purpose

This property is for transferring new point labels into a Graph Object which is being used in a real-time implementation. Existing point labels will first be shifted to make room for the new labels. Each string in the tab delimited array should be less than or equal to 48 characters in length.

Comments

This property is write-only and can only be used with PEvset. This property must be set before AppendYData. For more information on the use of this property see AppendYData. Also refer to Chapter 7, Question 26.

Within the demo, see example 017.

The following examples pass 4 strings, you would do this if you were updating 4 samples in one timer event. Many times you will just be passing one string for one new sample. Passing multiple samples can be used to transfer more data into a control with few fewer image updates. This puts less burden on the system.

.NET Example

Dim CurrentTime As String

'// new point label //
CurrentTime = Now.Hour.ToString + ":" + Now.Minute.ToString + ":" + Now.Second.ToString

'// transfer new point label //
Gigasoft.ProEssentials.Api.PEvset(Pego1.PeSpecial.hObject, Gigasoft.ProEssentials.DllProperties.APPENDPOINTLABELDATA, CurrentTime, 1)

C / C++ Example

/* 4 new tab delimited point labels */

char szPointLabels[] = "56:04\t56:05\t56:06\t56:07\t";

PEvset (hWndPE, PEP_szaAPPENDPOINTLABELDATA, szPointlabels, 4);

OCX Example

This code adds 4 new point labels for 4 new samples.

t$ = Chr$(9) ** tab character **

L$ = "56:04"+t$+"56:05"+t$+"56:06"+t$+"56:07"+t$

test = PEvset (PEGraph1, PEP_szaAPPENDPOINTLABELDATA, ByVal L$, 4)

VCL Example

This code adds 4 new point labels for 4 new samples.

var

L: String;

t: String;

tmpszstr: array[0 .. 64] of Char;

{** new point labels **}

t := Chr(9);

L := '56:04' + t + '56:05' + t + '56:06' + t + '56:07' + t;

StrPCopy(tmpszstr, L);

{** transfer new point label **}

PEvset(PEGraph1.hObject,PEP_szaAPPENDPOINTLABELDATA,@tmpszstr,4);


Gigasoft Home \| News \| Contact Us \| Purchase a new License or Upgrade Product/Patches \| Resource Files Online Documentation
©2022 Gigasoft, Inc. \| All rights reserved. Gigasoft is a registered trademark, and ProEssentials a trademark of Gigasoft, Inc.