Scripts.Item(Object) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Core

Assembly:: office.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne un membre de la Scripts collection.

public:
 Microsoft::Office::Core::Script ^ Item(System::Object ^ Index);

public Microsoft.Office.Core.Script Item (object Index);

abstract member Item : obj -> Microsoft.Office.Core.Script

Public Function Item (Index As Object) As Script

Paramètres

Index: Object

Objet obligatoire. ID ou numéro d’index du script à retourner.

Retours

Script

Remarques

Accepte le numéro d’index ou l’ID du script que vous souhaitez que l’application Microsoft Office retourne. La méthode Item accepte une valeur Object qui peut accepter un nombre ordinal (valeur d’index), qui retourne le script stocké à cette position dans la collection Scripts , ou une valeur String qui représente le nom ou l’ID du script.

La collection Scripts contient tous les scripts d’un document donné, dans l’ordre source (l’ordre dans lequel Script les objets apparaissent dans le fichier source). Les scripts sont conservés dans l’ordre de la source, quel que soit leur emplacement dans le document, c’est-à-dire, qu’ils se trouvent dans l’en-tête ou le corps du texte.

Vous pouvez utiliser la méthode Item pour accéder à un script dans la collection Scripts à l’aide de l’ID de la <balise SCRIPT> . L’attribut ID de la <balise SCRIPT> est identique à la Id propriété de l’objet Script . S’il existe plusieurs ID dupliqués dans le document et que vous utilisez la propriété Id d’un objet Script pour accéder à un script à l’aide de la méthode Item , Office renvoie le premier script qui correspond à l’ID ; les scripts supplémentaires avec le même ID sont ignorés.

Les nouvelles ancres de script ajoutées à la collection sont ajoutées à la fin de la collection Scripts dans l’ordre dans lequel elles ont été ajoutées au document. Les ancres de script restent dans cet ordre jusqu’à ce que le document soit enregistré au format HTML, fermé, puis rouvert dans l’application hôte. En suivant ces étapes, la collection Scripts est indexée dans l’ordre dans lequel les ancres de script apparaissent dans le document, ce qui peut être différent de l’ordre dans lequel ils y ont été ajoutés. Par conséquent, il est recommandé d’utiliser la propriété Id de l’objet Script , plutôt que la position du script dans la collection, pour garantir une identification positive du script.

S’applique à

Partager via