IDebugDocumentPosition2::GetRange

  • Articolo

Ottiene l'intervallo per la posizione del documento.

Sintassi

int GetRange( 
   TEXT_POSITION[] pBegPosition,
   TEXT_POSITION[] pEndPosition
);

Parametri

pBegPosition
[in, out] Struttura TEXT_POSITION compilata con la posizione iniziale. Impostare questo argomento su un valore Null se queste informazioni non sono necessarie.

pEndPosition
[in, out] Struttura TEXT_POSITION riempita con la posizione finale. Impostare questo argomento su un valore Null se queste informazioni non sono necessarie.

Valore restituito

Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore.

Osservazioni:

L'intervallo specificato in una posizione del documento per un punto di interruzione della posizione viene utilizzato dal motore di debug (DE) per cercare in avanti un'istruzione che contribuisce effettivamente al codice. Si consideri il codice di esempio seguente:

Line 5: // comment
Line 6: x = 1;

La riga 5 non contribuisce al codice del programma sottoposto a debug. Se il debugger che imposta il punto di interruzione nella riga 5 desidera che il DE esegua una ricerca in avanti per una determinata quantità per la prima riga che contribuisce al codice, il debugger specifica un intervallo che include righe candidate aggiuntive in cui potrebbe essere posizionato correttamente un punto di interruzione. Il de esegue quindi una ricerca in avanti tra le righe fino a quando non trova una riga che potrebbe accettare un punto di interruzione.

Vedi anche