IDebugDocumentHost::GetScriptTextAttributesIDebugDocumentHost::GetScriptTextAttributes

Retourne les attributs de texte d’un bloc de texte du document.Returns the text attributes for a block of document text.

SyntaxeSyntax

HRESULT GetScriptTextAttributes(  
   LPCOLESTR          pstrCode,  
   ULONG              uNumCodeChars,  
   LPCOLESTR          pstrDelimiter,  
   DWORD              dwFlags,  
   SOURCE_TEXT_ATTR*  pattr  
);  

ParamètresParameters

pstrCode
[in] Le texte de bloc de script.[in] The script block text. Cette chaîne n’a pas besoin de se terminer par null.This string does not need to be null terminated.

uNumCodeChars
[in] Le nombre de caractères dans le texte de bloc de script.[in] The number of characters in the script block text.

pstrDelimiter
[in] Adresse du délimiteur de fin du bloc de script.[in] Address of the end-of-script-block delimiter. Lorsque pstrCode est analysé à partir d’un flux de texte, l’hôte utilise généralement un délimiteur, telles que les guillemets («), pour détecter la fin du bloc de script.When pstrCode is parsed from a stream of text, the host typically uses a delimiter, such as two single quotation marks (''), to detect the end of the script block. Ce paramètre spécifie le délimiteur de l’hôte utilisé, ce qui permet au moteur de script pour fournir certains prétraitement primitifs conditionnelle (par exemple, en remplaçant un guillemet simple ['] par deux guillemets simples à utiliser comme délimiteur).This parameter specifies the delimiter that the host used, allowing the scripting engine to provide some conditional primitive preprocessing (for example, replacing a single quotation mark ['] with two single quotation marks for use as a delimiter). Exactement comment (et si) le moteur script utilise ces informations varient selon le moteur de script.Exactly how (and if) the scripting engine uses this information depends on the scripting engine. Définissez ce paramètre avec la valeur NULL si l’hôte n’utilisez pas un délimiteur pour marquer la fin du bloc de script.Set this parameter to NULL if the host did not use a delimiter to mark the end of the script block.

dwFlags
[in] Indicateurs associés au bloc de script.[in] Flags associated with the script block. Peut être une combinaison des valeurs suivantes :Can be a combination of these values:

ConstanteConstant ValeurValue DescriptionDescription
GETATTRTYPE_DEPSCANGETATTRTYPE_DEPSCAN 0 x 00010x0001 Indique que les opérateurs de point et les identificateurs doivent être identifiés avec les indicateurs SOURCETEXT_ATTR_IDENTIFIER et SOURCETEXT_ATTR_MEMBERLOOKUP, respectivement.Indicates that identifiers and dot operators should be identified with the SOURCETEXT_ATTR_IDENTIFIER and SOURCETEXT_ATTR_MEMBERLOOKUP flags, respectively.
GETATTRFLAG_THISGETATTRFLAG_THIS 0 x 01000x0100 Indique que l’identificateur de l’objet en cours doit être identifié avec l’indicateur SOURCETEXT_ATTR_THIS.Indicates that the identifier for the current object should be identified with the SOURCETEXT_ATTR_THIS flag.
GETATTRFLAG_HUMANTEXTGETATTRFLAG_HUMANTEXT 0 x 80000x8000 Indique que le texte de commentaire et de contenu de chaîne doit être identifié avec l’indicateur SOURCETEXT_ATTR_HUMANTEXT.Indicates that string content and comment text should be identified with the SOURCETEXT_ATTR_HUMANTEXT flag.

pattr
[dans, out] Mémoire tampon devant contenir les attributs retournés.[in, out] Buffer to contain the returned attributes.

Valeur de retourReturn Value

La méthode retourne HRESULT.The method returns an HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.Possible values include, but are not limited to, those in the following table.

ValeurValue DescriptionDescription
S_OK La méthode a réussi.The method succeeded.
E_NOTIMPL L’hôte utilise uniquement les attributs par défaut.The host uses only default attributes.

RemarquesRemarks

Cette méthode retourne les attributs de texte pour un bloc arbitraire du texte du document.This method returns the text attributes for an arbitrary block of document text. Il est acceptable pour les ordinateurs hôtes à retourner E_NOTIMPL, auquel cas les attributs par défaut sont utilisés.It is acceptable for hosts to return E_NOTIMPL, in which case the default attributes are used.

Voir aussiSee Also

IDebugDocumentHost (Interface) IDebugDocumentHost Interface
Énumération SOURCE_TEXT_ATTRSOURCE_TEXT_ATTR Enumeration