NumberingChange Klasse

Definition

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Paket:

DocumentFormat.OpenXml v3.0.1

Vorherige Absatznummerierungseigenschaften.

Diese Klasse ist in Office 2007 und höher verfügbar.

Wenn das Objekt als xml serialisiert wird, lautet der qualifizierte Name w:numberingChange.

public class NumberingChange : DocumentFormat.OpenXml.OpenXmlLeafElement

type NumberingChange = class
    inherit OpenXmlLeafElement

Public Class NumberingChange
Inherits OpenXmlLeafElement

Vererbung

Object

OpenXmlElement

OpenXmlLeafElement

NumberingChange

Hinweise

[ISO/IEC 29500-1 1. Auflage]

numberingChange (Previous Numbering Field Properties)

Dieses Element gibt den vorherigen Zustand der Nummerierung an, die von einem LISTNUM-Feld (Teil 1, §17.16.5.33) in einem WordprocessingML-Dokument angezeigt wird, wenn zusätzliche LISTNUM-Felder hinzugefügt und Überarbeitungen nachverfolgt werden.

[Begründung: Der vom Feld LISTNUMbereitgestellte Legacy-Nummerierungsmechanismus basiert auf dem Vorhandensein von Feldern im Ausführungsinhalt des Dokuments, anstatt eine Absatzeigenschaft zu sein (wie die Nummerierung in der Regel dargestellt wird). Aus diesem Grund müssen diese Felder ihren vorherigen Zustand als eindeutigen Revisionstyp im Feldzeichen des Nummerierungsfelds speichern. end rationale]

Wenn dieses Element für ein Feld bereitgestellt wird, das nicht vom Typ LISTNUM ist, wie durch seine Feldfunktionen definiert (Teil 1, §17.16.5), dann wird diese Eigenschaft ignoriert.

[Beispiel: Betrachten Sie den folgenden Absatz, der ein einzelnes LISTNUM-Feld enthält, wie folgt:

5ccbfcbb-0568-4f98-b9e6-bc9b07df5295

Wenn im Dokument ein weiteres LISTNUM-Feld hinzugefügt wird, was zu einer Auswertung mit einer anderen Zahl führt, wie folgt:

5df1502e-4833-48c7-aa49-517de8059a13

Diese Revision des Feldergebnisses wird in WordprocessingML wie folgt gespeichert:

<w:fldChar w:fldCharType="begin">  
  <w:numberingChange w:id="0" … w:original="1." />  
</w:fldChar>  
<w:r>  
  <w:instrText>LISTNUM</w:instrText>  
</w:r>  
<w:fldChar w:fldCharType="separate"/>  
<w:r>  
  <w:t>2.</w:t>  
</w:r>  
<w:fldChar w:fldCharType="end" />  

Das numberingChange-Element gibt an, dass die Nummerierung, die sich aus diesem LISTNUM-Feld ergibt, geändert und diese Änderung als Revision nachverfolgt wurde. Das vorherige Nummerierungsergebnis von 1. wird im ursprünglichen Attribut zwischengespeichert. Ende des Beispiels]

Bei Nummerierungsfeldern muss das ursprüngliche Attribut die vorherige Nummerierung angeben, die vom übergeordneten LISTNUM-Feld in einem WordprocessingML-Dokument angezeigt wird. Diese Informationen sind ein leistungssteigernder Cache des Zustands der Nummerierung vor der Revision, damit Anwendungen den vorherigen Zustand anzeigen können, ohne alle LISTNUM-Felder im Dokument neu berechnen zu müssen.

Wenn dieses Attribut nicht angegeben wird, wird kein vorheriger Nummerierungswert impliziert, und Anwendungen können diesen Wert berechnen oder keinen vorherigen Nummerierungswert anzeigen.

[Beispiel: Betrachten Sie den folgenden Absatz, der ein einzelnes LISTNUM-Feld mit einer Revision enthält, wie folgt:

5df1502e-4833-48c7-aa49-517de8059a13

Diese Revision des Feldergebnisses wird in WordprocessingML wie folgt gespeichert:

<w:fldChar w:fldCharType="begin">  
  <w:numberingChange w:id="0" … w:original="1." />  
</w:fldChar>  

Das ursprüngliche Attribut gibt an, dass der vorherige Nummerierungswert des Felds 1 war.Endbeispiel]

Übergeordnete Elemente
fldChar (Teil 1, §17.16.18)

[Hinweis: Die W3C-XML-Schemadefinition des Inhaltsmodells (CT_TrackChangeNumbering) dieses Elements befindet sich in §A.1. Ende des Hinweises]

[ISO/IEC 29500-1 1. Auflage]

numberingChange (Previous Paragraph Numbering Properties)

Dieses Element gibt den vorherigen Zustand der Nummerierung eines Absatzes an, wenn Überarbeitungen nachverfolgt werden.

[Begründung: Dieser Mechanismus wird einfach verwendet, um Speicher für Revisionen der Nummerierung bereitzustellen, die von älteren Textverarbeitungsanwendungen erstellt wurden, und Anwendungen werden empfohlen, das pPrChange-Element zu verwenden, um diese Änderungen stattdessen als Änderungen an den Absatzeigenschaften zu speichern. end rationale]

[Beispiel: Betrachten Sie die folgende Liste mit arabischen Ziffern als Nummerierung, wie folgt:

f1e61028-5796-4a3c-aaeb-f786fa603b64

Stellen Sie sich eine Überarbeitung vor, bei der die Nummerierungsdefinition wie folgt von arabischen in römische Ziffern geändert wird:

e9f215fe-31e8-463c-a9b7-1f97d607869b

Diese Revision der Nummerierungsdefinition wird in WordprocessingML wie folgt gespeichert:

<w:p>  
<w:pPr>  
<w:numPr>  
<w:ilvl w:val="0" />  
<w:numId w:val="1" />  
<w:numberingChange w:id="0" … w:original="%1:1:0:." />  
</w:numPr>  
</w:pPr>  
<w:r>  
<w:t>one</w:t>  
</w:r>  
</w:p>  
<w:p>  
<w:pPr>  
<w:numPr>  
<w:ilvl w:val="0" />  
<w:numId w:val="1" />  
<w:numberingChange w:id="1" … w:original="%1:2:0:." />  
</w:numPr>  
</w:pPr>  
<w:r>  
<w:t>two</w:t>  
</w:r>  
</w:p>  
<w:p>  
<w:pPr>  
<w:numPr>  
<w:ilvl w:val="0" />  
<w:numId w:val="1" />  
<w:numberingChange w:id="2" … w:original="%1:3:0:." />  
</w:numPr>  
</w:pPr>  
<w:r>  
<w:t>three</w:t>  
</w:r>  
</w:p>  

Das numberingChange-Element gibt an, dass die Nummerierungsdefinition geändert und diese Änderung als Revision nachverfolgt wurde. Die vorherige arabische Numeralnummerierungsdefinition wird im ursprünglichen Attribut zwischengespeichert. Ende des Beispiels]

Bei der Absatznummerierung muss das ursprüngliche Attribut die vorherige Nummerierungsdefinition für einen einzelnen Textabsatz in einem WordprocessingML-Dokument angeben, während Überarbeitungen nachverfolgt werden.

Der Wert von original wird als separate Definitionen der Nummerierungsebene dargestellt, die wie folgt definiert sind:

<%[numbering level]:[nfc value]:[numbering format]:[separator]>[repeat if more than one level]  

wo

• Nummerierungsebene – Die Ebene, für die die Nummerierungsdefinition definiert ist

• nfc-Wert – Der Wert der Nummerierungsart auf der spezifischen Nummerierungsebene

• Nummerierungsformat : Der NFC-Wert des Nummerierungsformats, auf den in der folgenden Tabelle verwiesen wird.

• separator : Das Trennzeichen, das zum Trennen der Definitionen der Nummerierungsebene verwendet wird.

Die Werte des Nummerierungsformats werden wie folgt zugeordnet:

nfc-Wert

ST_NumberFormat Enumerationsäquivalent

0

dezimal

1

upperRoman

2

lowerRoman

3

upperLetter

4

lowerLetter

5

Ordinale

6

cardinalText

7

ordinalText

8

Fluch

9

Chicago

10

ideographDigital

11

japaneseCounting

12

Aiueo

13

Iroha

14

decimalFullWidth

15

decimalHalfWidth

16

japaneseLegal

17

japaneseDigitalTenThousand

18

decimalEnclosedCircle

19

decimalFullWidth2

20

aiueoFullWidth

21

irohaFullWidth

22

decimalZero

23

Kugel

24

ganada

25

chosung

26

decimalEnclosedFullstop

27

decimalEnclosedParen

28

decimalEnclosedCircleChinese

29

ideographEnclosedCircle

30

ideographTraditional

31

ideographZodiac

32

ideographZodiacTraditional

33

taiwaneseCounting

34

ideographLegalTraditional

35

taiwaneseCountingThousand

36

taiwaneseDigital

37

chineseCounting

38

chinesischLegal Vereinfacht

39

chineseCountingThousand

40

Anwendungsdefiniert. Kann ignoriert werden.

41

koreanDigital

42

koreanCounting

43

koreanLegal

44

koreanDigital2

45

hebräisch1

46

arabicAlpha

47

hebräisch2

48

arabicAbjad

49

hindiVowels

50

hindiConsonants

51

hindiNumbers

52

hindiCounting

53

thaiLetters

54

thaiNumbers

55

thaiCounting

56

vietnameseCounting

57

numberInDash

58

russianLower

59

russianUpper

60 oder höher

Anwendungsdefiniert. Kann ignoriert werden.

[Beispiel: Betrachten Sie den folgenden nummerierten Absatz, in dem sich die Nummerierungsdefinition geändert hat, während Überarbeitungen nachverfolgt werden, wie folgt:

1295cca3-f9de-4aec-9347-8baae6e0f1b0

Diese Revision des nummerierten Absatzes wird in WordprocessingML wie folgt gespeichert:

<w:numPr>  
  …  
  <w:numberingChange … w:original="%1:1:0:.%2:1:2:.%3:1:0:." />  
</w:numPr>  

Im obigen Beispiel gibt es drei Ebenen in der ursprünglichen Nummerierungsdefinition, daher sind drei Definitionen der Nummerierungsebene erforderlich, um die ursprüngliche Nummerierungsdefinition darzustellen.

Die erste Ebene wird von %1 angegeben und gibt an, dass es sich um den Zahlenwert 1 im NFC-Format 0 (Arabisch) handelte.

Das ursprüngliche Attribut gibt an, dass die vorherige Nummerierungsdefinition aus drei Ebenen bestand, deren Wert 1.i.1. war.Endbeispiel]

Übergeordnete Elemente
numPr (Teil 1, §17.3.1.19)

[Hinweis: Die W3C-XML-Schemadefinition des Inhaltsmodells (CT_TrackChangeNumbering) dieses Elements befindet sich in §A.1. Ende des Hinweises]

ISO/IEC29500: 2008.

Konstruktoren

NumberingChange()

Initialisiert einen neuen instance der NumberingChange-Klasse.

Eigenschaften

Author	Autor Stellt das folgende Attribut im Schema dar: w:author
ChildElements	Ruft alle untergeordneten Knoten des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Date	date Stellt das folgende Attribut im Schema dar: w:date
DateUtc	dateUtc, diese Eigenschaft ist nur in Microsoft365 und höher verfügbar. Stellt das folgende Attribut im Schema dar: w16du:dateUtc
ExtendedAttributes	Ruft alle erweiterten Attribute (Attribute, die im Schema nicht definiert sind) des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Features	Ruft ein IFeatureCollection für das aktuelle Element ab. Diese Featuresammlung ist schreibgeschützt, erbt jedoch Features von ihrem übergeordneten Teil und Paket, falls verfügbar. (Geerbt von OpenXmlElement)
FirstChild	Ruft das erste untergeordnete Element des OpenXmlElement-Elements ab. Gibt null (Nothing in Visual Basic) zurück, wenn kein solches OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
HasAttributes	Ruft einen Wert ab, der angibt, ob das aktuelle Element über Attribute verfügt. (Geerbt von OpenXmlElement)
HasChildren	Ruft einen Wert ab, der angibt, ob das aktuelle Element über untergeordnete Elemente verfügt. (Geerbt von OpenXmlLeafElement)
Id	Anmerkungsbezeichner Stellt das folgende Attribut im Schema dar: w:id
InnerText	Ruft die verketteten Werte des Knotens und aller untergeordneten Elemente ab oder legt diese fest. (Geerbt von OpenXmlElement)
InnerXml	Ruft das Markup ab, das nur untergeordnete Elemente des aktuellen Elements darstellt, oder legt dieses fest. (Geerbt von OpenXmlLeafElement)
LastChild	Ruft das letzte untergeordnete Element des OpenXmlElement-Elements ab. Gibt null (Nothing in Visual Basic) zurück, wenn kein solches OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
LocalName	Ruft den lokalen Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
MCAttributes	Ruft die Markupkompatibilitätsattribute ab oder legt sie fest. Gibt NULL zurück, wenn für das aktuelle Element keine Markupkompatibilitätsattribute definiert sind. (Geerbt von OpenXmlElement)
NamespaceDeclarations	Ruft alle im aktuellen Element definierten Namespacedeklarationen ab. Gibt einen leeren Enumerator zurück, wenn keine Namespacedeklaration vorhanden ist. (Geerbt von OpenXmlElement)
NamespaceUri	Ruft den Namespace-URI des aktuellen Elements ab. (Geerbt von OpenXmlElement)
OpenXmlElementContext	Ruft den OpenXmlElementContext des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Original	Original Stellt das folgende Attribut im Schema dar: w:original
OuterXml	Ruft das Markup ab, das das aktuelle Element und alle untergeordneten Elemente darstellt. (Geerbt von OpenXmlElement)
Parent	Ruft das übergeordnete Element des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Prefix	Ruft das Namespacepräfix des aktuellen Elements ab. (Geerbt von OpenXmlElement)
XmlQualifiedName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
XName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)

Methoden

AddAnnotation(Object)	Fügt der Liste der Anmerkungen des aktuellen OpenXmlElement-Elements ein -Objekt hinzu. (Geerbt von OpenXmlElement)
AddNamespaceDeclaration(String, String)	Fügt dem aktuellen Knoten eine Namespacedeklaration hinzu. (Geerbt von OpenXmlElement)
Ancestors()	Listet alle Vorgängerelemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Ancestors<T>()	Listet nur die Vorgänger des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
Annotation(Type)	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotation<T>()	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations(Type)	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations<T>()	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Fügt jedes Element aus einer Liste von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
Append(OpenXmlElement[])	Fügt jedes Element aus einem Array von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
AppendChild<T>(T)	Fügt das angegebene Element am Ende der Liste der untergeordneten Knoten des aktuellen Elements an. (Geerbt von OpenXmlElement)
ClearAllAttributes()	Löscht alle Attribute, einschließlich bekannter und erweiterter Attribute. (Geerbt von OpenXmlElement)
Clone()	Erstellt ein Duplikat des aktuellen Knotens. (Geerbt von OpenXmlElement)
CloneNode(Boolean)	Erstellt ein Duplikat dieses Knotens.
Descendants()	Listet alle Nachfolger des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Descendants<T>()	Listet alle Nachfolger des aktuellen Elements vom Typ T auf. (Geerbt von OpenXmlElement)
Elements()	Listet alle untergeordneten Elemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Elements<T>()	Listet nur die untergeordneten Elemente des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
ElementsAfter()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element folgen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
ElementsBefore()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element vorausgehen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
GetAttribute(String, String)	Ruft ein Open XML-Attribut mit dem angegebenen Tagnamen und Namespace-URI ab. (Geerbt von OpenXmlElement)
GetAttributes()	Ruft eine Liste ab, die eine Kopie aller Attribute enthält. (Geerbt von OpenXmlElement)
GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)
GetFirstChild<T>()	Sucht das erste untergeordnete Element im Typ T. (Geerbt von OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar nach dem angegebenen Verweiselement ein. (Geerbt von OpenXmlElement)
InsertAfterSelf<T>(T)	Fügt das angegebene Element unmittelbar nach dem aktuellen Element ein. (Geerbt von OpenXmlElement)
InsertAt<T>(T, Int32)	Fügt das angegebene Element am angegebenen Index in die Liste der untergeordneten Elemente des aktuellen Elements ein. (Geerbt von OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar vor dem angegebenen Verweiselement ein. (Geerbt von OpenXmlElement)
InsertBeforeSelf<T>(T)	Fügt das angegebene Element unmittelbar vor dem aktuellen Element ein. (Geerbt von OpenXmlElement)
IsAfter(OpenXmlElement)	Bestimmt, ob das aktuelle Element nach einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
IsBefore(OpenXmlElement)	Bestimmt, ob das aktuelle Element vor einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
LookupNamespace(String)	Löst das Namespacepräfix im Kontext des aktuellen Knotens auf. (Geerbt von OpenXmlElement)
LookupPrefix(String)	Sucht das entsprechende Präfix für einen Namespace-URI im aktuellen Elementbereich. (Geerbt von OpenXmlElement)
NextSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
NextSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement vorhanden ist. (Geerbt von OpenXmlElement)
PrependChild<T>(T)	Fügt das angegebene Element am Anfang der Liste der untergeordneten Elemente des aktuellen Elements ein. (Geerbt von OpenXmlElement)
PreviousSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar vor dem aktuellen OpenXmlElement-Element steht. Gibt null (Nothing in Visual Basic ) zurück, wenn kein vorangehendes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
PreviousSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der dem aktuellen OpenXmlElement vorangestellt ist. Gibt null (Nothing in Visual Basic) zurück, wenn kein vorheriges OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
Remove()	Entfernt das aktuelle Element aus dem übergeordneten Element. (Geerbt von OpenXmlElement)
RemoveAllChildren()	Entfernt alle untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlLeafElement)
RemoveAllChildren<T>()	Entfernen Sie alle untergeordneten Elemente des aktuellen Elements vom Typ T. (Geerbt von OpenXmlElement)
RemoveAnnotations(Type)	Entfernt die Anmerkungen des angegebenen Typs aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAnnotations<T>()	Entfernt die Anmerkungen mit dem angegebenen Typ aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAttribute(String, String)	Entfernt das Attribut aus dem aktuellen Element. (Geerbt von OpenXmlElement)
RemoveChild<T>(T)	Entfernt das angegebene untergeordnete Element aus der Liste der untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlElement)
RemoveNamespaceDeclaration(String)	Entfernt die Namespacedeklaration für das angegebene Präfix. Entfernt nichts, wenn kein Präfix vorhanden ist. (Geerbt von OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Ersetzt ein untergeordnetes Element durch ein anderes untergeordnetes Element in der Liste der untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Legt ein Attribut auf das angegebene Element fest. Wenn das Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn es sich bei dem Attribut um ein erweitertes Attribut handelt, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Legt eine Reihe von Attributen für das -Element fest. Wenn ein Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn ein Attribut ein erweitertes Attribut ist, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
WriteTo(XmlWriter)	Speichert den aktuellen Knoten im angegebenen XmlWriter. (Geerbt von OpenXmlElement)

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()	Vorherige Absatznummerierungseigenschaften. Diese Klasse ist in Office 2007 und höher verfügbar. Wenn das Objekt als xml serialisiert wird, lautet der qualifizierte Name w:numberingChange. (Geerbt von OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)