Partilhar via


IDebugDocumentPosition2::GetRange

Obtém o intervalo para esta posição do documento.

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

Parâmetros

  • pBegPosition
    [in, out] A TEXT_POSITION estrutura que é preenchida com a posição inicial. Defina este argumento como um valor nulo se essa informação não for necessário.

  • pEndPosition
    [in, out] A TEXT_POSITION estrutura que é preenchida com a posição final. Defina este argumento como um valor nulo se essa informação não for necessário.

Valor de retorno

Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.

Comentários

O intervalo especificado em uma posição de documento para um ponto de interrupção local é usado pelo mecanismo de depuração (DE) para procurar uma instrução que realmente contribui código com antecedência. Por exemplo, considere o código a seguir:

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

Linha 5 não contribui nenhum código de programa que está sendo depurado. Se quiser que o depurador que define o ponto de interrupção na linha 5 DE pesquisar frente uma certa para a primeira linha que contribua com código, o depurador deve especificar um intervalo que inclui linhas adicionais do candidato, onde um ponto de interrupção poderia ser colocado corretamente. O DE seria então procurar nos próximos essas linhas até ele encontrar uma linha que pôde aceitar um ponto de interrupção.

Consulte também

Referência

IDebugDocumentPosition2

TEXT_POSITION