IActiveScriptParse32::AddScriptletIActiveScriptParse32::AddScriptlet

Ajoute un scriptlet du code pour le script.Adds a code scriptlet to the script. Cette méthode est utilisée dans les environnements où l’état permanent du script est étroitement avec le document de l’hôte et l’hôte est chargé pour la restauration du script, plutôt que dans un IPersist* interface.This method is used in environments where the persistent state of the script is intertwined with the host document and the host is responsible for restoring the script, rather than through an IPersist* interface. Les exemples principales sont des langages de script HTML qui autorisent les scriptlets de code incorporé dans le document HTML à attacher aux événements intrinsèques (par exemple, ONCLICK="button1.text='Exit' »).The primary examples are HTML scripting languages that allow scriptlets of code embedded in the HTML document to be attached to intrinsic events (for instance, ONCLICK="button1.text='Exit'").

SyntaxeSyntax

HRESULT AddScriptlet(  
    LPCOLESTR pstrDefaultName,       // address of default name of scriptlet  
    LPCOLESTR pstrCode,              // address of scriptlet text  
    LPCOLESTR pstrItemName,          // address of item name  
    LPCOLESTR pstrSubItemName,       // address of subitem name  
    LPCOLESTR pstrEventName,         // address of event name  
    LPCOLESTR pstrDelimiter,         // address of end-of-scriptlet delimiter  
    DWORD_PTR dwSourceContextCookie, // application-defined value for debugging  
    ULONG ulStartingLineNumber,      // starting line of the script  
    DWORD dwFlags,                   // scriptlet flags  
    BSTR *pbstrName,                 // address of actual name of scriptlet  
    EXCEPINFO *pexcepinfo            // address of exception information  
);  

ParamètresParameters

pstrDefaultName
[in] Adresse d’un nom de valeur par défaut pour associer le scriptlet.[in] Address of a default name to associate with the scriptlet. Si le scriptlet ne contient pas les informations d’affectation de noms (comme dans l’exemple ONCLICK ci-dessus), ce nom sera utilisé pour identifier le scriptlet.If the scriptlet does not contain naming information (as in the ONCLICK example above), this name will be used to identify the scriptlet. Si ce paramètre est NULL, le moteur de script fabrique un nom unique, si nécessaire.If this parameter is NULL, the scripting engine manufactures a unique name, if necessary.

pstrCode
[in] Adresse du scriptlet texte à ajouter.[in] Address of the scriptlet text to add. L’interprétation de cette chaîne varie selon le langage de script.The interpretation of this string depends on the scripting language.

pstrItemName
[in] Adresse d’une mémoire tampon qui contient le nom de l’élément associé à ce scriptlet.[in] Address of a buffer that contains the item name associated with this scriptlet. Ce paramètre, en plus de pstrSubItemName, identifie l’objet pour lequel le scriptlet est un gestionnaire d’événements.This parameter, in addition to pstrSubItemName, identifies the object for which the scriptlet is an event handler.

pstrSubItemName
[in] Adresse d’une mémoire tampon qui contient le nom d’un subobject de l’élément nommé avec lequel ce scriptlet est associé ; ce nom doit se trouver dans les informations de type de l’élément nommé.[in] Address of a buffer that contains the name of a subobject of the named item with which this scriptlet is associated; this name must be found in the named item's type information. Ce paramètre est NULL si le scriptlet doit être associé à l’élément nommé à la place d’un subitem.This parameter is NULL if the scriptlet is to be associated with the named item instead of a subitem. Ce paramètre, en plus de pstrItemName, identifie l’objet spécifique pour lequel le scriptlet est un gestionnaire d’événements.This parameter, in addition to pstrItemName, identifies the specific object for which the scriptlet is an event handler.

pstrEventName
[in] Adresse d’une mémoire tampon qui contient le nom de l’événement pour lequel le scriptlet est un gestionnaire d’événements.[in] Address of a buffer that contains the name of the event for which the scriptlet is an event handler.

pstrDelimiter
[in] Adresse de fin-de-scriptlet délimiteur.[in] Address of the end-of-scriptlet delimiter. Lorsque le pstrCode paramètre 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 scriptlet.When the pstrCode parameter 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 scriptlet. 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 script permet de moteur dépend de l’utilisation de ces informations sur le moteur de script.Exactly how (and if) the scripting engine makes use of 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 scriptlet.Set this parameter to NULL if the host did not use a delimiter to mark the end of the scriptlet.

dwSourceContextCookie
[in] Valeur définie par l’application qui est utilisée à des fins de débogage.[in] Application-defined value that is used for debugging purposes.

ulStartingLineNumber
[in] Valeur de base zéro qui spécifie la ligne à laquelle l’analyse commencera à.[in] Zero-based value that specifies which line the parsing will begin at.

dwFlags
[in] Indicateurs associés le scriptlet.[in] Flags associated with the scriptlet. Peut être une combinaison des valeurs suivantes :Can be a combination of the following values:

Valeur de retourReturn Value SignificationMeaning
SCRIPTTEXT_ISVISIBLESCRIPTTEXT_ISVISIBLE Indique que le texte du script doit être visible (et, par conséquent, peut être appelé par nom) en tant qu’une méthode globale dans l’espace de noms du script.Indicates that the script text should be visible (and, therefore, callable by name) as a global method in the name space of the script.
SCRIPTTEXT_ISPERSISTENTSCRIPTTEXT_ISPERSISTENT Indique que le code ajouté au cours de cet appel doit être enregistré si le moteur de script est enregistré (par exemple, via un appel à IPersist*::Save), ou si le moteur de script est réinitialisé par le biais d’une transition à l’état initialisé.Indicates that the code added during this call should be saved if the scripting engine is saved (for example, through a call to IPersist*::Save), or if the scripting engine is reset by way of a transition back to the initialized state. Pour plus d’informations sur cet état, voir les États de moteur de Script.For more information about this state, see Script Engine States.

pbstrName ,pbstrName ,
[out] Nom réel utilisé pour identifier le scriptlet.[out] Actual name used to identify the scriptlet. Cela doit être dans l’ordre de préférence : un nom spécifié explicitement dans le texte du scriptlet, le nom par défaut fourni dans pstrDefaultName, ou un nom unique synthétisés par le moteur de script.This is to be in order of preference: a name explicitly specified in the scriptlet text, the default name provided in pstrDefaultName, or a unique name synthesized by the scripting engine.

pexcepinfo ,pexcepinfo ,
[out] Adresse d’une structure contenant des informations sur l’exception.[out] Address of a structure containing exception information. Cette structure doit être renseignée lorsque DISP_E_EXCEPTION est retourné.This structure should be filled in if DISP_E_EXCEPTION is returned.

Valeur de retourReturn Value

Retourne l’une des valeurs suivantes :Returns one of the following values:

Valeur de retourReturn Value SignificationMeaning
S_OK Opération réussie.Success.
DISP_E_EXCEPTION Une exception s’est produite lors de l’analyse du scriptlet.An exception occurred in the parsing of the scriptlet. Le pexcepinfo paramètre contient des informations sur l’exception.The pexcepinfo parameter contains information about the exception.
E_INVALIDARG Un argument n’était pas valide.An argument was invalid.
E_NOTIMPL Cette méthode n’est pas prise en charge ; le moteur de script ne prend pas en charge l’ajout scriptlets de recevoir des événements.This method is not supported; the scripting engine does not support adding event-sinking scriptlets.
E_POINTER Un pointeur non valide a été spécifié.An invalid pointer was specified.
E_UNEXPECTED L’appel n’était pas attendu (par exemple, le moteur de script n'a pas encore été chargé ou initialisé) et par conséquent a échoué.The call was not expected (for example, the scripting engine has not yet been loaded or initialized) and therefore failed.
OLESCRIPT_E_INVALIDNAME Le nom par défaut fourni n’est pas valide dans ce langage de script.The default name supplied is invalid in this scripting language.
OLESCRIPT_E_SYNTAX Une erreur de syntaxe non spécifiée s’est produite dans le scriptlet.An unspecified syntax error occurred in the scriptlet.

Voir aussiSee Also

IActiveScriptParse32IActiveScriptParse32