IActiveScriptProperty::SetPropertyIActiveScriptProperty::SetProperty

Définit la propriété qui est spécifiée par le paramètre.Sets the property that is specified by the parameter.

SyntaxeSyntax

HRESULT SetProperty(  
// The property value:  
    uint dwProperty,    
// Not used:   
    IntPtr pvarIndex,    
// The value of the property:   
    out object pvarValue,    
);  

ParamètresParameters

dwProperty
Valeur de propriété à définir.The property value to set.

pvarIndex
Non utilisé.Not used.

pvarValue
Valeur de la propriété.The value of the property.

Les valeurs autorisées pour dwProperty sont décrits dans le tableau suivant.The values allowed for dwProperty are described in the following table.

ConstanteConstant ValueValue SignificationMeaning
SCRIPTPROP_INTEGERMODESCRIPTPROP_INTEGERMODE 0x000030000x00003000 Force le moteur de script pour diviser en mode entier plutôt qu’en mode de point flottant.Forces the scripting engine to divide in integer mode instead of floating point mode. La valeur par défaut est False.The default value is False.
SCRIPTPROP_STRINGCOMPAREINSTANCESCRIPTPROP_STRINGCOMPAREINSTANCE 0x000030010x00003001 Permet à la fonction de comparaison de chaîne du moteur de script à remplacer.Allows the string compare function of the scripting engine to be replaced.
SCRIPTPROP_ABBREVIATE_GLOBALNAME_RESOLUTIONSCRIPTPROP_ABBREVIATE_GLOBALNAME_RESOLUTION 0x700000020x70000002 Informe le moteur de script sans les autres moteurs de script existent pour contribuer à l’objet global.Informs the scripting engine that no other scripting engines exist to contribute to the global object.
SCRIPTPROP_INVOKEVERSIONINGSCRIPTPROP_INVOKEVERSIONING 0x000040000x00004000 Force le JavaScriptJavaScript moteur de script pour sélectionner un ensemble de fonctionnalités de langage pris en charge.Forces the JavaScriptJavaScript scripting engine to select a set of language features to be supported. L’ensemble par défaut de fonctionnalités de langage pris en charge par le JavaScriptJavaScript moteur de script est équivalent à l’ensemble de fonctionnalités de langage qui s’est affiché dans la version 5.7 de la JavaScriptJavaScript moteur de script.The default set of language features supported by the JavaScriptJavaScript scripting engine is equivalent to the language feature set that appeared in version 5.7 of the JavaScriptJavaScript scripting engine.

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 is not valid.
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).

NotesRemarks

Pour activer ou désactiver la division entière, appeler SetProperty et convertir un Boolean à un Object.To enable or disable integer division, invoke SetProperty and convert a Boolean to an Object. Par défaut, la valeur de propriété est False.By default, the property value is False. Si vous le définissez sur True, les opérations de division retournera uniquement des entiers.If you set it to True, division operations will return only integers.

Pour activer ou désactiver la comparaison de chaînes personnalisé, vous devez appeler SetProperty et passez un Object valeur.To enable or disable custom string comparison, invoke SetProperty and pass in an Object value. L’objet que vous passez doit implémenter l’interface IActiveScriptStringCompare (Interface).The object that you pass in must implement the interface IActiveScriptStringCompare Interface. Le StrComp méthode de la IActiveScriptStringCompare (Interface) interface est appelée chaque fois qu’une fonction de comparaison de chaîne est exécutée.The StrComp method of the IActiveScriptStringCompare Interface interface is called every time that a string compare function is executed.

Pour sélectionner le jeu de fonctionnalités de langage pris en charge lorsque le JavaScriptJavaScript moteur de script est initialisé, appeler SetProperty et transmettre une valeur qui correspond à la fonctionnalité de langage définie doit être activé pour SCRIPTPROP_INVOKEVERSIONING.To select the set of language features to be supported when the JavaScriptJavaScript scripting engine is initialized, invoke SetProperty and pass a value that corresponds to the language feature set to be enabled for SCRIPTPROP_INVOKEVERSIONING. Si cette propriété est définie sur 1 (SCRIPTLANGUAGEVERSION_5_7), les fonctionnalités de langage disponibles sont les mêmes que celles qui s’est affiché dans la version 5.7 de la JavaScriptJavaScript moteur de script.If this property is set to 1 (SCRIPTLANGUAGEVERSION_5_7), the available language features are the same as those that appeared in version 5.7 of the JavaScriptJavaScript scripting engine. Si elle est définie sur 2 (SCRIPTLANGUAGEVERSION_5_8), les fonctionnalités de langage disponibles sont ceux qui s’est affiché dans la version 5.7, en plus des nouvelles fonctionnalités qui ont été ajoutées dans la version 5.8.If it is set to 2 (SCRIPTLANGUAGEVERSION_5_8), the available language features are those that appeared in version 5.7 in addition to new features that were added in version 5.8. Par défaut, cette propriété est définie sur 0 (SCRIPTLANGUAGEVERSION_DEFAULT), ce qui équivaut à l’ensemble de fonctionnalités de langage qui s’est affiché dans la version 5.7, sauf si l’hôte prend en charge un comportement par défaut différente.By default, this property is set to 0 (SCRIPTLANGUAGEVERSION_DEFAULT), which is equivalent to the language feature set that appeared in version 5.7, unless the host supports a different default behavior. Par exemple, Internet Explorer 8 accepte le JavaScriptJavaScript des fonctionnalités de langage qui sont pris en charge par la version 5.8 JavaScriptJavaScript moteur de script par défaut lorsque le mode de document par défaut pour Internet Explorer 8 est en mode « Normes Internet Explorer 8 ».For example, Internet Explorer 8 opts into the JavaScriptJavaScript language features that are supported by the version 5.8 JavaScriptJavaScript scripting engine by default when the default document mode for Internet Explorer 8 is "Internet Explorer 8 Standards" mode. Soit le mode de document Internet Explorer 8 pour les normes d’Internet Explorer 7 ou le mode Quirks réinitialise le JavaScriptJavaScript moteur de script pour prendre en charge uniquement l’ensemble de fonctionnalités de langage qui existaient dans la version 5.7 JavaScriptJavaScript moteur de script.Switching the Internet Explorer 8 document mode to Internet Explorer 7 Standards or Quirks mode resets the JavaScriptJavaScript scripting engine to support only the language feature set that existed in the version 5.7 JavaScriptJavaScript scripting engine.

Note

SCRIPTPROP_INVOKEVERSIONING doit être définie uniquement lorsque le JavaScriptJavaScript est en cours d’initialisation du moteur de script.SCRIPTPROP_INVOKEVERSIONING should be set only when the JavaScriptJavaScript scripting engine is being initialized.

ExempleExample

L’exemple suivant montre comment forcer le moteur de script à utiliser la division d’entier et permettre la surcharge de la fonction de comparaison.The following example shows how to force the scripting engine to use integer division and how to allow overloading of the compare function.

BMLScriptEngine bmlScriptEngine = new BMLScriptEngine();  
IActiveScriptProperty scriptProperties = bmlScriptEngine as   
    IActiveScriptProperty;  

// Force the scripting engine to use integer division.  
Boolean enableIntegerDivision = true;  
Object vtIntegerDivInstance = (Object)enableIntegerDivision;  
                scriptProperties.SetProperty(SCRIPTPROP_INTEGERDIVISION,   
    System.IntPtr.Zero, ref vtIntegerDivInstance);  

// Allow overloading of the compare function.  
BMLScriptStringCompare bmlScriptStringCompareInstance = new   
    BMLScriptStringCompare();  
Object vtStrCmpInstance = (Object)bmlScriptStringCompareInstance;  
scriptProperties.SetProperty(SCRIPTPROP_STRCOMPINST,   
    System.IntPtr.Zero, ref vtStrCmpInstance);  

Voir aussiSee Also

Définition de la compatibilité de Document Defining Document Compatibility
IActiveScriptProperty IActiveScriptProperty
Informations de versionVersion Information