Promotic
WikipediaLinkedInYoutubeTwitterFacebook

RemovePoints - method of object tvPoints

Description:
Removes the data points from the buffer according to the sFilter,vParam parameters. By the parameter is it possible, for example, to specify if the points from the whole buffer or only from the visible part of the buffer are removed.
Syntax:
RemovePoints(sFilter As String, [vParam As Variant])
Calling:
oPoints.RemovePoints sFilter, vParam
Parameters:
sFilter(String) Range of values that will be removed. For example text in the form of range:all;time:lt;.
"range" - Range of values that will be removed. For example text in the form of range:all;.
"all" - All values that are in the buffer. If the time parameter is set, then all values from the buffer are removed but only till the time value set by the parameters time, vParam.
"visible" - The values that are in the moment of calling in the visible part of the buffer. If the time parameter is set, then all values from the visible part are removed but only till the time value set by the parameters time, vParam.
"one" - Only one value. It has sense only when the time parameter is set, it removes the value according the parameters time, vParam.
"time" - Specifies which values are removed from the buffer. In this case it is necessary to set the vParam parameter.
"near" - The point closest to the time set in the vParam parameter is removed from the buffer. In this case the range parameter isn't taken into consideration.
"gt" - All values according to the range parameter are removed from the buffer and they are greater than the time entered in the vParam parameter.
"ge" - All values according to the range parameter are removed from the buffer and they are greater or equal the time entered in the vParam parameter.
"lt" - All values according to the range parameter are removed from the buffer and they are less than the time entered in the vParam parameter.
"le" - All values according to the range parameter are removed from the buffer and they are less or equal the time entered in the vParam parameter.
vParam[optional] (Variant) Time that specifies the range of values that will be removed. It is entered only when the time parameter is set.
Note:
This is relevant only for trends that are not connected to data source (to a variable in the PmTrend object).
See also:
Example1:
Example removes all values from the buffer that are less or equal to the time: 18.11.2016 22:00:00.
Dim sFilter, vParam
sFilter = "range:all;time:le;"
vParam = Pm.CreateDate(2016,11,18, 22,0,0,0)
oPoints.RemovePoints sFilter, vParam
Example2:
Example removes one value from the buffer that is closest to the entered time: 18.11.2016 22:00:00.
Dim sFilter, vParam
sFilter = "time:near;"
vParam = Pm.CreateDate(2016,11,18, 22,0,0,0)
oPoints.RemovePoints sFilter, vParam
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice