IActiveScript::AddNamedItemIActiveScript::AddNamedItem

Ajoute le nom d’un élément de niveau racine pour l’espace de noms du moteur de script.Adds the name of a root-level item to the scripting engine's name space. Un élément de niveau racine est un objet avec les propriétés et méthodes, une source d’événement ou tous les trois.A root-level item is an object with properties and methods, an event source, or all three.

SyntaxeSyntax

HRESULT AddNamedItem(  
    LPCOLESTR pstrName,  // address of item name  
    DWORD dwFlags          // item flags  
);  

ParamètresParameters

pstrName
[in] Adresse d’une mémoire tampon qui contient le nom de l’élément tel qu’affiché à partir du script.[in] Address of a buffer that contains the name of the item as viewed from the script. Le nom doit être unique et persistante.The name must be unique and persistable.

dwFlags
[in] Indicateurs associés à un élément.[in] Flags associated with an item. Peut être une combinaison des valeurs suivantes :Can be a combination of these values:

ValueValue SignificationMeaning
SCRIPTITEM_CODEONLYSCRIPTITEM_CODEONLY Indique que l’élément nommé représente un objet de code uniquement, et que l’hôte n’a aucun IUnknown à associer à cet objet de code uniquement.Indicates that the named item represents a code-only object, and that the host has no IUnknown to be associated with this code-only object. L’hôte a seulement un nom pour cet objet.The host only has a name for this object. Dans les langages orientés objet tels que C++, cet indicateur créerait une classe.In object-oriented languages such as C++, this flag would create a class. Tous les langages ne prennent en charge cet indicateur.Not all languages support this flag.
SCRIPTITEM_GLOBALMEMBERSSCRIPTITEM_GLOBALMEMBERS Indique que l’élément est une collection de propriétés globales et de méthodes associés au script.Indicates that the item is a collection of global properties and methods associated with the script. Normalement, un moteur de script ignore le nom d’objet (autre que pour les besoins de l’utiliser comme un cookie pour le IActiveScriptSite::GetItemInfo (méthode), ou la résolution de portée explicite) et exposer ses membres comme global les variables et méthodes.Normally, a scripting engine would ignore the object name (other than for the purpose of using it as a cookie for the IActiveScriptSite::GetItemInfo method, or for resolving explicit scoping) and expose its members as global variables and methods. Cela permet à l’hôte étendre la bibliothèque (fonctions d’exécution et ainsi de suite) disponible pour le script.This allows the host to extend the library (run-time functions and so on) available to the script. Il est laissé au moteur de script à traiter avec le nom est en conflit (par exemple, lorsque deux éléments SCRIPTITEM_GLOBALMEMBERS proposent des méthodes du même nom), même si une erreur ne doit pas être retournée en raison de cette situation.It is left to the scripting engine to deal with name conflicts (for example, when two SCRIPTITEM_GLOBALMEMBERS items have methods of the same name), although an error should not be returned because of this situation.
SCRIPTITEM_ISPERSISTENTSCRIPTITEM_ISPERSISTENT Indique que l’élément doit être enregistré si le moteur de script est enregistré.Indicates that the item should be saved if the scripting engine is saved. De même, la définition de cet indicateur indique qu’une transition vers l’état initialisé doit conserver nom et le type d’informations de l’élément (le moteur de script doit, cependant, libérer tous les pointeurs vers les interfaces sur l’objet réel).Similarly, setting this flag indicates that a transition back to the initialized state should retain the item's name and type information (the scripting engine must, however, release all pointers to interfaces on the actual object).
SCRIPTITEM_ISSOURCESCRIPTITEM_ISSOURCE Indique que l’élément d'où proviennent les événements que le script peut recevoir.Indicates that the item sources events that the script can sink. Objets enfants (les propriétés de l’objet qui sont eux-mêmes des objets) peuvent également extraire des événements au script.Child objects (properties of the object that are in themselves objects) can also source events to the script. Ce n’est pas récursive, mais il fournit un mécanisme commode pour le cas courant, par exemple, de la création des contrôles d’un conteneur et tous ses membres.This is not recursive, but it provides a convenient mechanism for the common case, for example, of creating a container and all of its member controls.
SCRIPTITEM_ISVISIBLESCRIPTITEM_ISVISIBLE Indique que le nom de l’élément est disponible dans l’espace de noms du script, autoriser l’accès aux propriétés, méthodes et événements de l’élément.Indicates that the item's name is available in the name space of the script, allowing access to the properties, methods, and events of the item. Par convention, les propriétés de l’élément incluent enfants de l’élément ; Par conséquent, toutes les propriétés de l’objet enfant et les méthodes (et leurs enfants, de manière récursive) seront plus accessibles.By convention the properties of the item include the item's children; therefore, all child object properties and methods (and their children, recursively) will be accessible.
SCRIPTITEM_NOCODESCRIPTITEM_NOCODE Indique que l’élément est simplement un nom qui est ajouté à l’espace de noms du script et ne doit pas être considérée comme un élément pour lequel le code doit être associé.Indicates that the item is simply a name being added to the script's name space, and should not be treated as an item for which code should be associated. Par exemple, sans cet indicateur est défini, VBScript créera un module séparé pour l’élément nommé, et C++ peuvent créer une classe wrapper séparé pour l’élément nommé.For example, without this flag being set, VBScript will create a separate module for the named item, and C++ might create a separate wrapper class for the named item.

Valeur de retourReturn Value

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

Valeur de retourReturn Value SignificationMeaning
S_OK Opération réussie.Success.
E_INVALIDARG Un argument n’est pas valide.An argument was invalid.
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é).The call was not expected (for example, the scripting engine has not yet been loaded or initialized).

Voir aussiSee Also

IActiveScriptIActiveScript