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énements ou 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é dans le script.[in] Address of a buffer that contains 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] 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:

ValeurValue SignificationMeaning
SCRIPTITEM_CODEONLYSCRIPTITEM_CODEONLY Indique que l’élément nommé représente un objet de code uniquement, et que l’ordinateur hôte n’a aucune 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ée une classe.In object-oriented languages such as C++, this flag would create a class. Pas de tous les langages 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 étant global les variables et les 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 afin d’é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 ont des méthodes portant le même nom), bien qu’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 les informations de nom et le type 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. Des objets enfants (les propriétés de l’objet qui sont eux-mêmes des objets) peuvent également obtenir des événements au script.Child objects (properties of the object that are in themselves objects) can also source events to the script. Cela n’est pas récursive, mais il fournit un mécanisme commode pour le cas courant, par exemple, de créer 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, permettant d’accéder 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 est ajouté à l’espace de noms du script et ne doit pas être considéré 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 distinct pour l’élément nommé et C++ peut créer une classe wrapper distincts 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 l’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’était 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