Método IDataModelScriptDebugBreakpoint::GetPosition (dbgmodel.h)
O método GetPosition retorna a posição do ponto de interrupção dentro do script. O depurador de script deve retornar a linha e a coluna dentro do código-fonte em que o ponto de interrupção está localizado. Se for capaz de fazer isso, ele também poderá retornar um intervalo de origem representado pelo ponto de interrupção preenchendo uma posição final, conforme definido pelo argumento positionSpanEnd. Se o depurador não for capaz de produzir esse intervalo e o chamador o solicitar, os campos Linha e Coluna da posição final do intervalo deverão ser preenchidos como zero, indicando que os valores não podem ser fornecidos.
O depurador também pode retornar o texto da linha (ou intervalo) do código-fonte em que o ponto de interrupção existe no argumento lineText. Embora seja altamente recomendável que os depuradores retornem esse valor, ele não é necessário. Somente a posição da linha e da coluna na origem são valores retornados necessários. Se o depurador não puder produzir o texto de origem, nullptr poderá ser retornado no argumento lineText.
Sintaxe
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parâmetros
position
A posição de linha e coluna do ponto de interrupção dentro do código-fonte do script deve ser retornada aqui.
positionSpanEnd
Se o depurador for capaz de produzir o intervalo de origem representado pelo ponto de interrupção, ele poderá retornar as posições de linha e coluna do final do intervalo aqui. Caso contrário, os valores de Linha e Coluna da estrutura devem ser definidos como zero, indicando que os valores não podem ser fornecidos.
lineText
Se o depurador puder produzir a linha (ou intervalo) do código-fonte representado pelo ponto de interrupção, ele retornará como uma cadeia de caracteres alocada por meio da função SysAllocString. O chamador é responsável por liberar a cadeia de caracteres retornada por meio de SysFreeString. Se o depurador não puder retornar esse texto de origem, nullptr deverá ser retornado aqui.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |