IActiveScriptAuthor::AddNamedItemIActiveScriptAuthor::AddNamedItem

Ajoute le nom d’un élément de niveau racine pour l’espace de noms du moteur de création de script.Adds the name of a root-level item to the script authoring engine's namespace. A élément de niveau racine est un objet qui peut contenir des propriétés et méthodes, et qui peut également contenir une source d’événement.A root-level item is an object that can contain properties and methods, and that can also contain an event source.

SyntaxeSyntax

HRESULT AddNamedItem(  
   LPCOLESTR          pszName,  
   DWORD              dwFlags,  
   IDispatch          *pdisp  
);  

ParamètresParameters

pszName
[in] Le nom de l’élément tel qu’affiché dans le script.[in] The name of the item as viewed from the script. Le nom doit être unique et persistant.The name must be unique and persistable.

dwFlags
[in] Les indicateurs qui sont associés à l’élément nommé.[in] The flags that are associated with the named item. Peut être une combinaison des valeurs suivantes :Can be a combination of the following values:

ConstanteConstant ValeurValue DescriptionDescription
SCRIPTITEM_ISVISIBLESCRIPTITEM_ISVISIBLE 0x000000020x00000002 Indique que le nom de l’élément est disponible dans l’espace de noms du script.Indicates that the item's name is available in the namespace of the script. Cela autorise l’accès aux propriétés, méthodes et événements de l’élément.This allows access to the item's properties, methods, and events.

Par convention, les propriétés de l’élément incluent des membres enfants de l’élément.By convention, the properties of the item include the item's child members. Par conséquent, toutes les propriétés de l’objet enfant et les méthodes (et leurs membres enfants, de manière récursive) sont accessibles.Therefore, all child object properties and methods (and their child members, recursively) are accessible.
SCRIPTITEM_ISSOURCESCRIPTITEM_ISSOURCE 0x000000040x00000004 Indique les événements de la source de l’élément que le script peut avoir des gestionnaires d’événements de script.Indicates the item source's events that the script can have script event handlers.
SCRIPTITEM_GLOBALMEMBERSSCRIPTITEM_GLOBALMEMBERS 0x000000080x00000008 Indique que l’élément est une collection de propriétés globales et des méthodes qui sont associées au script.Indicates that the item is a collection of global properties and methods that are associated with the script. Ses membres sont créés en tant que les méthodes et les variables globales.Its members are authored as global variables and methods.
SCRIPTITEM_ISPERSISTENTSCRIPTITEM_ISPERSISTENT 0x000000400x00000040 Indique que l’élément doit être enregistré si le moteur de création de script est enregistré.Indicates that the item should be saved if the script authoring engine is saved.
SCRIPTITEM_CODEONLYSCRIPTITEM_CODEONLY 0x000002000x00000200 Indique que l’élément nommé représente un objet de code uniquement, et il n’a pas un membre à créer.Indicates that the named item represents a code-only object, and it does not have a member to author.
SCRIPTITEM_NOCODESCRIPTITEM_NOCODE 0x000004000x00000400 Indique que l’élément nommé est simplement un nom qui est ajouté, et il n’a rien à créer.Indicates that the named item is just a name being added, and it has nothing to author.

pdisp
[in] Le IDispatch de la NamedItem objet qui est utilisé pour collecter des méthodes, propriétés ou la source d’événements.[in] The IDispatch of the NamedItem object that is used to collect methods, properties, or the event source.

Valeur de retourReturn Value

Élément HRESULT.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

Voir aussiSee Also

IActiveScriptAuthor (Interface) IActiveScriptAuthor Interface
IActiveScriptAuthor::RemoveNamedItemIActiveScriptAuthor::RemoveNamedItem