SetCursorPos

<< Clique para Mostrar o Sumário >>

 

SetCursorPos

SetCursorPos(X, [Range])

Posiciona o cursor da Pena do E3Chart. O parâmetro X indica em qual posição o cursor deve ser posicionado, similar ao comportamento de mover o cursor na pesquisa com o mouse. O cursor é movido para a posição mais próxima indicada por X. O parâmetro Range é opcional e usado como validação. Se omitido, seu valor é igual a -1.0 (menos um). O cursor só é movido se o ponto válido estiver dentro do intervalo. Qualquer valor negativo indica que o intervalo passado não deve ser usado. O script a seguir contém um exemplo de uso deste método.

' Existindo um ponto válido em (x = 1, y = 10)
' e outro em (x = 4, y = 20).
SetCursorPos(2) ' move o cursor para o ponto (1, 10)
SetCursorPos(4) ' move o cursor para o ponto (4, 20)
 
' Quando range é usado, o cursor só é movido
' se ponto estiver dentro do range.
' Não vai mover o cursor, porque 2 está mais de 0.5 unidade
' distante do ponto mais próximo, que é 1.
SetCursorPos(2, 0.5)
' Envia o cursor para o ponto (1, 10).
SetCursorPos(2, 4)

 

Este método retorna Verdadeiro se o cursor foi movido, caso contrário retorna Falso.

Esta página foi útil?