IDebugDocumentHelper::DefineScriptBlockIDebugDocumentHelper::DefineScriptBlock

Indique à l’application d’assistance qu’une plage particulière de caractères est un bloc de script qui est géré par le moteur de script donné.Indicates to the helper that a particular range of characters is a script block that is handled by the given script engine.

SyntaxeSyntax

HRESULT DefineScriptBlock(  
   ULONG           ulCharOffset,  
   ULONG           cChars,  
   IActiveScript*  pas,  
   BOOL            fScriptlet,  
   DWORD_PTR*      pdwSourceContext  
);  

ParamètresParameters

ulCharOffset
[in] Emplacement de début du bloc de script.[in] Location of the start of the script block.

cChars
[in] Nombre de caractères dans le bloc de script.[in] Number of characters in the script block.

pas
[in] Le moteur de script pour ce bloc de script.[in] The script engine for this script block.

fScriptlet
[in] Indicateur qui indique si le bloc de script est un scriptlet.[in] Flag that indicates if the script block is a scriptlet.

pdwSourceContext
[out] Le contexte de la source pour le bloc de script.[out] The source context for the script block.

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.

RemarquesRemarks

Un hôte actif peut utiliser cette méthode lorsque ses documents contiennent des blocs de script intégrés.A smart host can use this method when its documents contain embedded script blocks. Un moteur de langage peut utiliser cette méthode lors de son code contient des scripts incorporés pour d’autres langues.A language engine can use this method when its code contains embedded scripts for other languages.

Le moteur de script est chargé de tous les syntaxe coloration du code contexte recherches et dans le bloc de script.The script engine is responsible for all syntax coloring and code context lookups in the script block.

Le DefineScriptBlock méthode doit être appelée une fois que le texte a été ajouté (par exemple, à l’aide de la IDebugDocumentHelper::AddDBCSText (méthode)) mais avant le script de bloc a été analysé (par exemple, à l’aide de la IActiveScriptParse ::ParseScriptText (méthode)).The DefineScriptBlock method should be called after the text has been added (for example, using the IDebugDocumentHelper::AddDBCSText method) but before the script block has been parsed (for example, using the IActiveScriptParse ::ParseScriptText method).

Voir aussiSee Also

IDebugDocumentHelper (Interface) IDebugDocumentHelper Interface
IDebugDocumentHelper::AddDBCSText IDebugDocumentHelper::AddDBCSText
IDebugDocumentHelper::AddUnicodeTextIDebugDocumentHelper::AddUnicodeText