CharacterIndexAtPos Metodo

Ottiene l'indice di un carattere in una certa posizione della pagina o nelle sue vicinanze. Se non c'è alcun carattere in corrispondenza del punto o nelle vicinanze, il valore restituito sarà -1. Se si verifica un errore, verrà restituito -3

L'indice basato su zero del carattere più vicino, -1 se nessun carattere ricade nell'area di tolleranza specificata, oppure -3 se si verifica un errore interno per esempio se non è caricata alcuna pagina

CharacterIndexAtPos mappa un punto nelle coordinate dello spazio utente PDF sull'indice del carattere più vicino nella pagina corrente. È l'operazione inversa della lettura di Character[Index] o RectangleCount: data una posizione (come un clic del mouse convertito in coordinate di pagina), identifica a quale carattere ha puntato l'utente.

I parametri X e Y specificano il punto di interrogazione in unità dello spazio utente PDF. L'origine è nell'angolo inferiore sinistro della pagina, con Y crescente verso l'alto. I parametri ToleranceX e ToleranceY estendono una regione di ricerca rettangolare attorno al punto di interrogazione; qualsiasi carattere il cui riquadro di delimitazione interseca quella regione è un candidato.

Se non viene trovato alcun carattere all'interno della regione di tolleranza, la funzione restituisce -1. Un valore di ritorno -3 indica un errore, in genere perché nessuna pagina è attualmente aperta. In caso di successo, l'indice restituito può essere passato direttamente a RectangleCount, Character, oppure usato come argomento StartIndex di FindFirst.

Quando si convertono coordinate dello schermo (in pixel) in coordinate dello spazio utente PDF, usa la larghezza e l'altezza della pagina insieme al livello di zoom corrente per ridimensionare opportunamente.

CharacterCount, Character, FindFirst, RectangleCount