Word.XmlNode class
Stellt einen einzelnen XML-Knoten dar, der auf das Dokument angewendet wird.
- Extends
Hinweise
Verwendet von
Eigenschaften
| attributes | Ruft die Attribute für diesen XML-Knoten ab. Gibt zurück |
| base |
Ruft den Namen des Elements ohne Präfix ab. |
| child |
Ruft die untergeordneten Elemente dieses XML-Knotens ab. Gibt eine leere Auflistung zurück, wenn der Knotentyp ist |
| context | Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden. |
| first |
Ruft den ersten untergeordneten Knoten ab, wenn dies ein übergeordneter Knoten ist. Gibt zurück |
| has |
Ruft ab, ob dieser XML-Knoten untergeordnete Knoten hat. Gibt immer für Attributknoten zurück |
| last |
Ruft den letzten untergeordneten Knoten ab, wenn dies ein übergeordneter Knoten ist. Gibt zurück |
| level | Ruft ab, ob dieses XML-Element Teil eines Absatzes ist, ein Absatz ist, in einer Tabellenzelle enthalten ist oder eine Tabellenzeile enthält. Gibt zurück |
| namespace |
Ruft den Uniform Resource Identifier (URI) des Schemanamespaces für diesen XML-Knoten ab. |
| next |
Ruft das nächste Element im Dokument ab, das sich auf derselben Ebene wie dieser XML-Knoten befindet. Gibt zurück |
| owner |
Ruft das übergeordnete Dokument dieses XML-Knotens ab. |
| parent |
Ruft das übergeordnete Element dieses XML-Knotens ab. |
| placeholder |
Gibt den für dieses Element angezeigten Text an, wenn es keinen Text enthält. Gilt nur für Elementknoten, nicht für Attributknoten. |
| previous |
Ruft das vorherige Element im Dokument ab, das sich auf derselben Ebene wie dieser XML-Knoten befindet. Gibt zurück |
| range | Ruft den Teil eines Dokuments ab, der in diesem XML-Knoten enthalten ist. Gibt zurück |
| text | Gibt den Text an, der im XML-Element enthalten ist. Gibt eine leere Zeichenfolge zurück, wenn der Knotentyp ist |
| type | Ruft den Knotentyp ab. |
| validation |
Ruft die Beschreibung für einen Validierungsfehler für dieses |
| validation |
Ruft ab, ob dieses Element gemäß dem angefügten Schema gültig ist. Für Attributknoten möglicherweise nicht aussagekräftig. |
| value | Gibt den Wert dieses XML-Knotens an. Stellt für Elementknoten den Textinhalt dar; stellt für Attributknoten den Attributwert dar. |
Methoden
| copy() | Kopiert diesen XML-Knoten mit Ausnahme von XML-Markup in die Zwischenablage. Kopiert bei Attributknoten nur den Attributwert als Text. |
| cut() | Entfernt diesen XML-Knoten aus dem Dokument und platziert ihn in der Zwischenablage. Entfernt bei Attributknoten das Attribut aus seinem übergeordneten Element und kopiert nur den Attributwert als Text in die Zwischenablage. |
| delete() | Löscht den XML-Knoten aus dem XML-Dokument. Entfernt für Elementknoten das gesamte Element und seinen Inhalt. Entfernt für Attributknoten das Attribut aus seinem übergeordneten Element. |
| load(options) | Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
| load(property |
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
| load(property |
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
| remove |
Entfernt ein untergeordnetes Element aus diesem XML-Knoten. Diese Methode hat keine Auswirkung, wenn der Knotentyp ( |
| select |
Gibt alle untergeordneten Elemente, die mit dem XPath-Parameter übereinstimmen, in der Reihenfolge zurück, in der sie in diesem XML-Knoten angezeigt werden. Gibt zurück |
| select |
Gibt das erste untergeordnete Element zurück, das mit dem XPath-Parameter in diesem XML-Knoten übereinstimmt. Gibt zurück |
| set |
Ändert den Validierungsfehlertext, der einem Benutzer für diesen XML-Knoten angezeigt wird, und gibt an, ob Word den Knoten als ungültig melden soll. Für Attributknoten möglicherweise nicht aussagekräftig. |
| set |
Ändert den Validierungsfehlertext, der einem Benutzer für diesen XML-Knoten angezeigt wird, und gibt an, ob Word den Knoten als ungültig melden soll. Für Attributknoten möglicherweise nicht aussagekräftig. |
| toJSON() | Überschreibt die JavaScript-Methode |
| track() | Nachverfolgung des Objekts zwecks automatischer Anpassung auf der Grundlage der umgebenden Änderungen im Dokument. Dieser Aufruf ist eine Kurzform für context.trackedObjects.add(thisObject). Wenn Sie dieses Objekt aufrufübergreifend |
| untrack() | Gibt den diesem Objekt zugewiesenen Arbeitsspeicher frei, wenn das Objekt zuvor nachverfolgt wurde. Dieser Aufruf ist die Kurzform für context.trackedObjects.remove(thisObject). Viele nachverfolgte Objekte verlangsamen die Ausführung der Hostanwendung, also achten Sie darauf, alle hinzugefügten Objekte nach abgeschlossener Verwendung freizugeben. Sie müssen einen Aufruf durchführen |
| validate() | Überprüft diesen XML-Knoten anhand der XML-Schemas, die an das Dokument angefügt sind. Für Attributknoten möglicherweise nicht aussagekräftig. |
Details zur Eigenschaft
attributes
Ruft die Attribute für diesen XML-Knoten ab. Gibt zurück null , ob der Knotentyp attributeist.
readonly attributes: Word.XmlNodeCollection;Eigenschaftswert
Hinweise
baseName
Ruft den Namen des Elements ohne Präfix ab.
readonly baseName: string;Eigenschaftswert
string
Hinweise
childNodes
Ruft die untergeordneten Elemente dieses XML-Knotens ab. Gibt eine leere Auflistung zurück, wenn der Knotentyp ist attribute.
readonly childNodes: Word.XmlNodeCollection;Eigenschaftswert
Hinweise
context
Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
context: RequestContext;Eigenschaftswert
firstChild
Ruft den ersten untergeordneten Knoten ab, wenn dies ein übergeordneter Knoten ist. Gibt zurück null , ob der Knotentyp attributeist.
readonly firstChild: Word.XmlNode;Eigenschaftswert
Hinweise
hasChildNodes
Ruft ab, ob dieser XML-Knoten untergeordnete Knoten hat. Gibt immer für Attributknoten zurück false , da diese keine untergeordneten Elemente haben können.
readonly hasChildNodes: boolean;Eigenschaftswert
boolean
Hinweise
lastChild
Ruft den letzten untergeordneten Knoten ab, wenn dies ein übergeordneter Knoten ist. Gibt zurück null , ob der Knotentyp attributeist.
readonly lastChild: Word.XmlNode;Eigenschaftswert
Hinweise
level
Ruft ab, ob dieses XML-Element Teil eines Absatzes ist, ein Absatz ist, in einer Tabellenzelle enthalten ist oder eine Tabellenzeile enthält. Gibt zurück null , ob der Knotentyp attributeist.
readonly level: Word.XmlNodeLevel | "Inline" | "Paragraph" | "Row" | "Cell";Eigenschaftswert
Word.XmlNodeLevel | "Inline" | "Paragraph" | "Row" | "Cell"
Hinweise
namespaceUri
Ruft den Uniform Resource Identifier (URI) des Schemanamespaces für diesen XML-Knoten ab.
readonly namespaceUri: string;Eigenschaftswert
string
Hinweise
nextSibling
Ruft das nächste Element im Dokument ab, das sich auf derselben Ebene wie dieser XML-Knoten befindet. Gibt zurück null , ob der Knotentyp attributeist.
readonly nextSibling: Word.XmlNode;Eigenschaftswert
Hinweise
ownerDocument
Ruft das übergeordnete Dokument dieses XML-Knotens ab.
readonly ownerDocument: Word.Document;Eigenschaftswert
Hinweise
parentNode
Ruft das übergeordnete Element dieses XML-Knotens ab.
readonly parentNode: Word.XmlNode;Eigenschaftswert
Hinweise
placeholderText
Gibt den für dieses Element angezeigten Text an, wenn es keinen Text enthält. Gilt nur für Elementknoten, nicht für Attributknoten.
placeholderText: string;Eigenschaftswert
string
Hinweise
previousSibling
Ruft das vorherige Element im Dokument ab, das sich auf derselben Ebene wie dieser XML-Knoten befindet. Gibt zurück null , ob der Knotentyp attributeist.
readonly previousSibling: Word.XmlNode;Eigenschaftswert
Hinweise
range
Ruft den Teil eines Dokuments ab, der in diesem XML-Knoten enthalten ist. Gibt zurück null , ob der Knotentyp attributeist.
readonly range: Word.Range;Eigenschaftswert
Hinweise
text
Gibt den Text an, der im XML-Element enthalten ist. Gibt eine leere Zeichenfolge zurück, wenn der Knotentyp ist attribute.
text: string;Eigenschaftswert
string
Hinweise
type
Hinweis
Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.
Ruft den Knotentyp ab.
readonly type: Word.XmlNodeType | "Element" | "Attribute";Eigenschaftswert
Word.XmlNodeType | "Element" | "Attribute"
Hinweise
validationErrorText
Ruft die Beschreibung für einen Validierungsfehler für dieses XmlNode Objekt ab. Für Attributknoten möglicherweise nicht aussagekräftig.
readonly validationErrorText: string;Eigenschaftswert
string
Hinweise
validationStatus
Ruft ab, ob dieses Element gemäß dem angefügten Schema gültig ist. Für Attributknoten möglicherweise nicht aussagekräftig.
readonly validationStatus: Word.XmlValidationStatus | "Ok" | "Custom";Eigenschaftswert
Word.XmlValidationStatus | "Ok" | "Custom"
Hinweise
value
Hinweis
Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.
Gibt den Wert dieses XML-Knotens an. Stellt für Elementknoten den Textinhalt dar; stellt für Attributknoten den Attributwert dar.
value: string;Eigenschaftswert
string
Hinweise
Details zur Methode
copy()
Kopiert diesen XML-Knoten mit Ausnahme von XML-Markup in die Zwischenablage. Kopiert bei Attributknoten nur den Attributwert als Text.
copy(): void;Gibt zurück
void
Hinweise
cut()
Entfernt diesen XML-Knoten aus dem Dokument und platziert ihn in der Zwischenablage. Entfernt bei Attributknoten das Attribut aus seinem übergeordneten Element und kopiert nur den Attributwert als Text in die Zwischenablage.
cut(): void;Gibt zurück
void
Hinweise
delete()
Löscht den XML-Knoten aus dem XML-Dokument. Entfernt für Elementknoten das gesamte Element und seinen Inhalt. Entfernt für Attributknoten das Attribut aus seinem übergeordneten Element.
delete(): void;Gibt zurück
void
Hinweise
load(options)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(options?: Word.Interfaces.XmlNodeLoadOptions): Word.XmlNode;Parameter
Stellt Optionen für die zu ladenden Eigenschaften des Objekts bereit.
Gibt zurück
load(propertyNames)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNames?: string | string[]): Word.XmlNode;Parameter
- propertyNames
-
string | string[]
Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.
Gibt zurück
load(propertyNamesAndPaths)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Word.XmlNode;Parameter
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select ist eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.
Gibt zurück
removeChild(childElement)
Entfernt ein untergeordnetes Element aus diesem XML-Knoten. Diese Methode hat keine Auswirkung, wenn der Knotentyp ( attribute da Attributknoten keine untergeordneten Elemente haben).
removeChild(childElement: Word.XmlNode): void;Parameter
- childElement
- Word.XmlNode
Das zu entfernende untergeordnete Element.
Gibt zurück
void
Hinweise
selectNodes(xPath, options)
Gibt alle untergeordneten Elemente, die mit dem XPath-Parameter übereinstimmen, in der Reihenfolge zurück, in der sie in diesem XML-Knoten angezeigt werden. Gibt zurück null , ob der Knotentyp ist attribute (da Attributknoten keine untergeordneten Elemente haben, die durchsucht werden können).
selectNodes(xPath: string, options?: Word.SelectNodesOptions): Word.XmlNodeCollection;Parameter
- xPath
-
string
Der auszuwertende XPath-Ausdruck.
- options
- Word.SelectNodesOptions
Optional. Konfigurationsoptionen für die XPath-Suche.
Gibt zurück
Eine Auflistung von XML-Knoten, die dem XPath-Ausdruck entsprechen.
Hinweise
selectSingleNode(xPath, options)
Gibt das erste untergeordnete Element zurück, das mit dem XPath-Parameter in diesem XML-Knoten übereinstimmt. Gibt zurück null , ob der Knotentyp ist attribute (da Attributknoten keine untergeordneten Elemente haben, die durchsucht werden können).
selectSingleNode(xPath: string, options?: Word.SelectSingleNodeOptions): Word.XmlNode;Parameter
- xPath
-
string
Der auszuwertende XPath-Ausdruck.
- options
- Word.SelectSingleNodeOptions
Optional. Konfigurationsoptionen für die XPath-Suche.
Gibt zurück
Der erste XML-Knoten, der mit dem XPath-Ausdruck übereinstimmt, oder null wenn keine Übereinstimmung gefunden wird.
Hinweise
setValidationError(status, options)
Ändert den Validierungsfehlertext, der einem Benutzer für diesen XML-Knoten angezeigt wird, und gibt an, ob Word den Knoten als ungültig melden soll. Für Attributknoten möglicherweise nicht aussagekräftig.
setValidationError(status: Word.XmlValidationStatus, options?: Word.XmlNodeSetValidationErrorOptions): void;Parameter
- status
- Word.XmlValidationStatus
Der festzulegende Validierungs-Status.
Optional. Konfigurationsoptionen zum Festlegen des Validierungsfehlers.
Gibt zurück
void
Hinweise
setValidationError(status, options)
Ändert den Validierungsfehlertext, der einem Benutzer für diesen XML-Knoten angezeigt wird, und gibt an, ob Word den Knoten als ungültig melden soll. Für Attributknoten möglicherweise nicht aussagekräftig.
setValidationError(status: "Ok" | "Custom", options?: Word.XmlNodeSetValidationErrorOptions): void;Parameter
- status
-
"Ok" | "Custom"
Der festzulegende Validierungs-Status.
Optional. Konfigurationsoptionen zum Festlegen des Validierungsfehlers.
Gibt zurück
void
Hinweise
toJSON()
Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche Word.XmlNode Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Word.Interfaces.XmlNodeData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.
toJSON(): Word.Interfaces.XmlNodeData;Gibt zurück
track()
Nachverfolgung des Objekts zwecks automatischer Anpassung auf der Grundlage der umgebenden Änderungen im Dokument. Dieser Aufruf ist eine Kurzform für context.trackedObjects.add(thisObject). Wenn Sie dieses Objekt aufrufübergreifend .sync und außerhalb der sequenziellen Ausführung eines ".run"-Batches verwenden und beim Festlegen einer Eigenschaft oder beim Aufrufen einer Methode für das Objekt ein "InvalidObjectPath"-Fehler angezeigt wird, müssen Sie das Objekt der nachverfolgten Objektsammlung hinzufügen, wenn das Objekt zum ersten Mal erstellt wurde. Wenn dieses Objekt Teil einer Sammlung ist, sollten Sie auch die übergeordnete Sammlung nachverfolgen.
track(): Word.XmlNode;Gibt zurück
untrack()
Gibt den diesem Objekt zugewiesenen Arbeitsspeicher frei, wenn das Objekt zuvor nachverfolgt wurde. Dieser Aufruf ist die Kurzform für context.trackedObjects.remove(thisObject). Viele nachverfolgte Objekte verlangsamen die Ausführung der Hostanwendung, also achten Sie darauf, alle hinzugefügten Objekte nach abgeschlossener Verwendung freizugeben. Sie müssen einen Aufruf durchführen context.sync() , bevor die Speicherfreigabe wirksam wird.
untrack(): Word.XmlNode;Gibt zurück
validate()
Überprüft diesen XML-Knoten anhand der XML-Schemas, die an das Dokument angefügt sind. Für Attributknoten möglicherweise nicht aussagekräftig.
validate(): void;Gibt zurück
void