IDataModelScriptDebugBreakpoint ::GetPosition, méthode (dbgmodel.h)
La méthode GetPosition retourne la position du point d’arrêt dans le script. Le débogueur de script doit retourner la ligne et la colonne dans le code source où se trouve le point d’arrêt. S’il est capable de le faire, il peut également retourner une étendue de source représentée par le point d’arrêt en remplissant une position de fin telle que définie par l’argument positionSpanEnd. Si le débogueur n’est pas en mesure de produire cette étendue et que l’appelant le demande, les champs Ligne et Colonne de la position de fin de l’étendue doivent être renseignés comme zéro, ce qui indique que les valeurs ne peuvent pas être fournies.
Le débogueur peut également retourner le texte de la ligne (ou de l’étendue) du code source où se trouve le point d’arrêt dans l’argument lineText. Bien qu’il soit fortement recommandé que les débogueurs retournent cette valeur, elle n’est pas obligatoire. Seules la position de ligne et de colonne dans la source sont des valeurs de retour requises. Si le débogueur ne peut pas produire le texte source, nullptr peut être retourné dans l’argument lineText.
Syntaxe
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Paramètres
position
La ligne et la position de colonne du point d’arrêt dans le code source du script doivent être retournées ici.
positionSpanEnd
Si le débogueur est capable de produire l’étendue de la source représentée par le point d’arrêt, il peut retourner les positions de ligne et de colonne de la fin de l’étendue ici. Si ce n’est pas le cas, les valeurs Line et Column de la structure doivent être définies sur zéro, ce qui indique que les valeurs ne peuvent pas être fournies..
lineText
Si le débogueur peut produire la ligne (ou l’étendue) du code source représenté par le point d’arrêt, il retourne comme ici une chaîne allouée via la fonction SysAllocString. L’appelant est responsable de la libération de la chaîne retournée via SysFreeString. Si le débogueur n’est pas en mesure de renvoyer ce texte source, nullptr doit être retourné ici.
Valeur retournée
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |