Promotic
WikipediaLinkedInYoutubeTwitterFacebook

GetIndexByTime - metoda objektu tvPoints

Popis:

Vyhledá index datového bodu podle zadaných parametrů. Hodnota indexu, jenž metoda vrací, je závislá na parametru nIndexType a je vztažena buď k celému bufferu nebo jen k viditelné oblasti bufferu.

Čas vTime je předpokládán podle nastavení vlastnosti TrendsView.TimeSetType tzn. "lokální čas", "zimní čas" nebo "letní čas".

Syntaxe:
GetIndexByTime(vTime As Variant, nStyle As Variant, nIndexType As Long) As Long
Volání:
n = oPoints.GetIndexByTime(vTime, nStyle, nIndexType)
Parametry:
vTime(Variant) Čas, podle něhož má být vyhledán datový bod
nStyle(Variant) Určení datového bodu vzhledem k času vTime
0 - bod, jehož čas je menší nebo rovno času vTime
1 - bod, jehož čas je větší nebo rovno času vTime
2 - časově nejbližší bod k času vTime
nIndexType(Long) Požadovaný typ vráceného indexu
0 - Index je vztažen k začatku bufferu
1 - Index je vztažen k prvnímu datovému bodu, jenž je zobrazen prohlížečem bufferu
Vrácená hodnota:
Metoda vrací index nalezeného bodu nebo -1, pokud není nalezen takový bod.
Příklad1:
Nechť buffer obsahuje celkem 100 datových bodů, z nichž 50 je zobrazeno prohlížečem a index prvního zobrazeného bodu je 7. Nechť metoda najde 1.bod, jenž vyhovuje času vTime podle nStyle a index tohoto bodu je 10. Pak při nastavení nIndexType na 0 je vrácena hodnota indexu 10, při nastavení na 1 je vrácena hodnota indexu 3.
Příklad2:
Čas má být zadáván jako "lokální čas" ("zimní čas" v zimním období a "letní čas" v letním období.):
oTView.TimeSetType = 1
nIndex = oPoints.GetIndexByTime(vTime, 0, 0) 'vTime je "lokální čas"
Příklad3:
Čas má být zadán jako "zimní čas" a to i v letním období:
oTView.TimeSetType = 2
nIndex = oPoints.GetIndexByTime(vTime, 0, 0) 'vTime je "zimní čas"
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice