Scripts.Item(Object) Methode

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Gibt ein Element der Scripts Auflistung zurück.

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

Parameter

Index

Object

Erforderliches Objekt. Die ID oder Indexnummer des zurückzugebenden Skripts.

Gibt zurück

Script

Hinweise

Akzeptiert die Indexnummer oder ID des Skripts, das von der Microsoft Office-Anwendung zurückgegeben werden soll. Die Item-Methode akzeptiert einen Object-Wert , der entweder eine Ordnungszahl (Indexwert) akzeptieren kann, die das an dieser Position in der Scripts-Auflistung gespeicherte Skript zurückgibt, oder einen String-Wert , der den Namen oder die ID des Skripts darstellt.

Die Scripts-Auflistung enthält alle Skripts in einem bestimmten Dokument in der Quellreihenfolge (die Reihenfolge, Script in der Objekte in der Quelldatei angezeigt werden). Skripts werden unabhängig von ihrer Position im Dokument in der Quellreihenfolge verwaltet, d. h. unabhängig davon, ob sie sich in der Kopfzeile oder im Textkörper befinden.

Sie können die Item-Methode verwenden, um auf ein Skript in der Scripts-Auflistung zuzugreifen, indem Sie die ID des <SCRIPT-Tags> verwenden. Das ID-Attribut des <SCRIPT-Tags> ist identisch mit der Id -Eigenschaft des Script-Objekts . Wenn das Dokument doppelte oder mehrere IDs enthält und Sie die Id-Eigenschaft eines Script-Objekts verwenden, um mithilfe der Item-Methode auf ein Skript zuzugreifen, gibt Office das erste Skript zurück, das der ID entspricht. zusätzliche Skripts mit der gleichen ID werden ignoriert.

Neue Skriptanker, die der Auflistung hinzugefügt wurden, werden an das Ende der Scripts-Auflistung in der Reihenfolge angefügt, in der sie dem Dokument hinzugefügt wurden. Die Skriptanker bleiben in dieser Reihenfolge, bis das Dokument als HTML gespeichert, geschlossen und dann in der Hostanwendung erneut geöffnet wird. Wenn Sie diese Schritte ausführen, wird die Scripts-Auflistung in der Reihenfolge indiziert, in der die Skriptanker im Dokument angezeigt werden, was sich von der Reihenfolge unterscheiden kann, in der sie hinzugefügt wurden. Daher wird empfohlen, die Id-Eigenschaft des Script-Objekts anstelle der Position des Skripts in der Auflistung zu verwenden, um eine positive Identifizierung des Skripts sicherzustellen.