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 indiquant que les valeurs ne peuvent pas être fournies.
Le débogueur peut également renvoyer 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, il n’est pas nécessaire. Seules les valeurs de retour requises sont requises pour la position de ligne et de colonne dans la source. 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 position de ligne et de colonne du point d’arrêt dans le code source du script doit être retournée ici.
positionSpanEnd
Si le débogueur est capable de produire l’étendue de source représentée par le point d’arrêt, elle 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 de ligne et de colonne 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, elle retourne ici une chaîne allouée via la fonction SysAllocString. L’appelant est chargé de libérer la chaîne retournée via SysFreeString. Si le débogueur n’est pas capable de retourner ce texte source, nullptr doit être retourné ici.
Valeur de retour
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Exigences
Exigence | Valeur |
---|---|
d’en-tête | dbgmodel.h |