NumberingChange Класс

Определение

Пространство имен:

DocumentFormat.OpenXml.Wordprocessing

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Предыдущие свойства нумеруляции абзаца.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — w:numberingChange.

public class NumberingChange : DocumentFormat.OpenXml.OpenXmlLeafElement

type NumberingChange = class
    inherit OpenXmlLeafElement

Public Class NumberingChange
Inherits OpenXmlLeafElement

Наследование

Object

OpenXmlElement

OpenXmlLeafElement

NumberingChange

Комментарии

[ISO/IEC 29500-1 1 издание]

numberingChange (Previous Numbering Field Properties)

Этот элемент указывает предыдущее состояние нумеровки, отображаемой полем LISTNUM (часть 1, §17.16.5.33) в документе WordprocessingML при добавлении дополнительных полей LISTNUM и отслеживании исправлений.

[Обоснование. Устаревший механизм нумеровки, предоставляемый полем LISTNUM , основан на наличии полей в содержимом выполнения документа, а не на свойстве абзаца (как правило, представляется нумерирование). По этой причине эти поля должны хранить свое предыдущее состояние в виде уникального типа редакции в символе поля нумеровки. end обоснование]

Если этот элемент предоставляется для поля, которое не относится к типу LISTNUM , как определено его кодами полей (часть 1, §17.16.5), то это свойство следует игнорировать.

[Пример. Рассмотрим следующий абзац, содержащий одно поле LISTNUM , следующим образом:

5ccbfcbb-0568-4f98-b9e6-bc9b07df5295

Если перед ним в документ добавляется другое поле LISTNUM , что приводит к его вычислению до другого числа, как показано ниже:

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

Эта редакция результата поля будет храниться в WordprocessingML следующим образом:

<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" />  

Элемент numberingChange указывает, что нумеровка, полученная из этого поля LISTNUM , была изменена, и это изменение отслеживалось как редакция. Предыдущий результат нумеровки 1. кэшируется в исходном атрибуте. конец примера

Для полей нумеровки исходный атрибут должен указывать предыдущую нумеровку, отображаемую родительским полем LISTNUM в документе WordprocessingML. Эти сведения являются кэшем, повышающим производительность состояния нумерации перед редакцией, чтобы приложения могли отображать предыдущее состояние без необходимости пересчета всех полей LISTNUM в документе.

Если этот атрибут опущен, то предыдущее значение нумерации не подразумевается, и приложения могут вычислить это значение или не отображать предыдущее значение нумерации.

[Пример. Рассмотрим следующий абзац, содержащий одно поле LISTNUM с редакцией следующим образом:

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

Эта редакция результата поля будет храниться в WordprocessingML следующим образом:

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

Исходный атрибут указывает, что предыдущее нумераторное значение поля было 1.пример end]

Родительские элементы
fldChar (Часть 1, §17.16.18)

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_TrackChangeNumbering) находится в §A.1. конечная заметка]

[ISO/IEC 29500-1 1 издание]

numberingChange (Previous Paragraph Numbering Properties)

Этот элемент указывает предыдущее состояние нумеровки абзаца при отслеживании изменений.

[Обоснование. Этот механизм просто используется для предоставления хранилища изменений нумерации, создаваемых устаревшими текстовыми приложениями, и приложениям рекомендуется использовать элемент pPrChange для хранения этих изменений в качестве изменений свойств абзаца. end обоснование]

[Пример. Рассмотрим следующий список с арабскими цифрами в качестве нумеровки, как показано ниже:

f1e61028-5796-4a3c-aaeb-f786fa603b64

Рассмотрим редакцию, в которой определение нумеровки изменяется с арабских цифр на римские, как показано ниже.

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

Эта редакция определения нумеровки будет храниться в WordprocessingML следующим образом:

<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>  

Элемент numberingChange указывает, что определение нумеровки было изменено, и это изменение отслеживалось как редакция. Предыдущее арабское определение нумератора кэшируется в исходном атрибуте. конец примера

Для нумеровки абзаца исходный атрибут должен указывать предыдущее определение нумеровки для отдельного абзаца текста в документе WordprocessingML во время отслеживания изменений.

Значение исходного кода представлено в виде отдельных определений уровня нумеровки, определенных следующим образом:

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

Где

• Уровень нумеровки — уровень, для которого определяется определение нумеровки.

• nfc value — значение стиля нумеровки на определенном уровне нумеровки.

• Формат нумеровки — значение nfc формата нумеровки, как указано в таблице ниже.

• разделитель — разделитель, используемый для разделения определений уровня нумеровки.

Значения нумерующего формата сопоставляются следующим образом:

Значение nfc

эквивалент перечисления ST_NumberFormat

0

Десятичных

1

upperRoman

2

lowerRoman

3

upperLetter

4

lowerLetter

5

Порядковый

6

cardinalText

7

ordinalText

8

Шестигранный

9

Чикаго

10

ideographDigital

11

japaneseCounting

12

Aiueo

13

Ироха

14

decimalFullWidth

15

decimalHalfWidth

16

japaneseLegal

17

japaneseDigitalTenThousand

18

decimalEnclosedCircle

19

decimalFullWidth2

20

aiueoFullWidth

21

irohaFullWidth

22

decimalZero

23

Пуля

24

ганада

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

chineseLegalSimplified

39

chineseCountingThousand

40

Определяемое приложением. Можно игнорировать.

41

koreanDigital

42

koreanCounting

43

koreanLegal

44

koreanDigital2

45

иврит1

46

arabicAlpha

47

иврит2

48

arabicAbjad

49

hindiVowels

50

хиндиКонсонанты

51

hindiNumbers

52

hindiCounting

53

thaiLetters

54

thaiNumbers

55

thaiCounting

56

vietnameseCounting

57

numberInDash

58

russianLower

59

russianUpper

60 или более поздней версии

Определяемое приложением. Можно игнорировать.

[Пример. Рассмотрим следующий нумерованный абзац, в котором определение нумеровки изменилось при отслеживании исправлений, как показано ниже.

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

Эта редакция нумерованного абзаца будет храниться в WordprocessingML следующим образом:

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

В приведенном выше примере в исходном определении нумеров есть три уровня, поэтому для представления исходного определения нумеровки требуются три определения уровня нумеровки.

Первый уровень задается %1 и указывает, что это было число 1 в nfc-формате 0 (арабский).

Исходный атрибут указывает, что предыдущее определение нумеровки было составлено из трех уровней, значение которых было 1.i.1..пример end]

Родительские элементы
numPr (часть 1, §17.3.1.19)

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_TrackChangeNumbering) находится в §A.1. конечная заметка]

ISO/IEC29500: 2008.

Конструкторы

NumberingChange()

Инициализирует новый экземпляр класса NumberingChange.

Свойства

Author	author Представляет следующий атрибут в схеме: w:author
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
Date	date Представляет следующий атрибут в схеме: w:date
DateUtc	dateUtc, это свойство доступно только в Microsoft365 и более поздних версиях. Представляет следующий атрибут в схеме: w16du:dateUtc
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Возвращает первый дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlLeafElement)
Id	Идентификатор заметки Представляет следующий атрибут в схеме: w:id
InnerText	Возвращает или задает объединенные значения узла и всех его дочерних элементов. (Унаследовано от OpenXmlElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafElement)
LastChild	Возвращает последний дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
Original	Исходный текст Представляет следующий атрибут в схеме: w:original
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
XmlQualifiedName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)
XName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)

Методы

AddAnnotation(Object)	Добавляет объект в список заметок текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
AddNamespaceDeclaration(String, String)	Добавляет объявление пространства имен в текущий узел. (Унаследовано от OpenXmlElement)
Ancestors()	Перечисляет все предки текущего элемента. (Унаследовано от OpenXmlElement)
Ancestors<T>()	Перечисляет только предки текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
Annotation(Type)	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotation<T>()	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations(Type)	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations<T>()	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Добавляет каждый элемент из списка элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
Append(OpenXmlElement[])	Добавляет каждый элемент из массива элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
AppendChild<T>(T)	Добавляет указанный элемент в конец списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlElement)
ClearAllAttributes()	Очищает все атрибуты, включая как известные, так и расширенные атрибуты. (Унаследовано от OpenXmlElement)
Clone()	Создает дубликат текущего узла. (Унаследовано от OpenXmlElement)
CloneNode(Boolean)	Создает дубликат этого узла.
Descendants()	Перечисляет все потомки текущего элемента. (Унаследовано от OpenXmlElement)
Descendants<T>()	Перечисление всех потомков текущего элемента типа T. (Унаследовано от OpenXmlElement)
Elements()	Перечисляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlElement)
Elements<T>()	Перечисляет только дочерние элементы текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
ElementsAfter()	Перечисляет все одноуровневые элементы, которые следуют за текущим элементом и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
ElementsBefore()	Перечисляет все одноуровневые элементы, которые предшествуют текущему элементу и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
GetAttribute(String, String)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от OpenXmlElement)
GetAttributes()	Возвращает список, содержащий копию всех атрибутов. (Унаследовано от OpenXmlElement)
GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)
GetFirstChild<T>()	Находит первый дочерний элемент в типе T. (Унаследовано от OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Вставляет указанный элемент сразу после указанного ссылочного элемента. (Унаследовано от OpenXmlElement)
InsertAfterSelf<T>(T)	Вставляет указанный элемент сразу после текущего элемента. (Унаследовано от OpenXmlElement)
InsertAt<T>(T, Int32)	Вставляет указанный элемент по указанному индексу в список дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Вставляет указанный элемент непосредственно перед указанным ссылочным элементом. (Унаследовано от OpenXmlElement)
InsertBeforeSelf<T>(T)	Вставляет указанный элемент непосредственно перед текущим элементом. (Унаследовано от OpenXmlElement)
IsAfter(OpenXmlElement)	Определяет, отображается ли текущий элемент после указанного элемента в порядке документа. (Унаследовано от OpenXmlElement)
IsBefore(OpenXmlElement)	Определяет, отображается ли текущий элемент перед указанным элементом в порядке документа. (Унаследовано от OpenXmlElement)
LookupNamespace(String)	Разрешает префикс пространства имен в контексте текущего узла. (Унаследовано от OpenXmlElement)
LookupPrefix(String)	Находит соответствующий префикс для URI пространства имен в текущем элементе область. (Унаследовано от OpenXmlElement)
NextSibling()	Возвращает элемент OpenXmlElement, который сразу же следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Remove()	Удаляет текущий элемент из родительского элемента. (Унаследовано от OpenXmlElement)
RemoveAllChildren()	Удаляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafElement)
RemoveAllChildren<T>()	Удалите все дочерние элементы текущего элемента типа T. (Унаследовано от OpenXmlElement)
RemoveAnnotations(Type)	Удаляет заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAnnotations<T>()	Удаляет заметки с указанным типом из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAttribute(String, String)	Удаляет атрибут из текущего элемента. (Унаследовано от OpenXmlElement)
RemoveChild<T>(T)	Удаляет указанный дочерний элемент из списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
RemoveNamespaceDeclaration(String)	Удаляет объявление пространства имен для указанного префикса. Ничего не удаляет, если нет префикса. (Унаследовано от OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Заменяет дочерний элемент другим дочерним элементом в списке дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
WriteTo(XmlWriter)	Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlElement)

Явные реализации интерфейса

IEnumerable.GetEnumerator()	Предыдущие свойства нумеруляции абзаца. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — w:numberingChange. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)