NumberingChange Classe

Definição

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Propriedades de Numeração de Parágrafos Anteriores.

Esta classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, o nome qualificado é w:numberingChange.

public class NumberingChange : DocumentFormat.OpenXml.OpenXmlLeafElement

type NumberingChange = class
    inherit OpenXmlLeafElement

Public Class NumberingChange
Inherits OpenXmlLeafElement

Herança

Object

OpenXmlElement

OpenXmlLeafElement

NumberingChange

Comentários

[ISO/IEC 29500-1 1st Edition]

numberingChange (Previous Numbering Field Properties)

Este elemento especifica o estado anterior da numeração apresentado por um campo LISTNUM (Parte 1, {17.16.5.33) num documento do WordprocessingML quando são adicionados campos LISTNUM adicionais e as revisões estão a ser controladas.

[Lógica: o mecanismo de numeração legado fornecido pelo campo LISTNUM baseia-se na presença de campos no conteúdo de execução do documento, em vez de ser uma propriedade de parágrafo (como a numeração é normalmente representada). Por este motivo, estes campos têm de armazenar o estado anterior como um tipo de revisão exclusivo no caráter de campo do campo de numeração. end rationale]

Se este elemento for fornecido para um campo que não seja do tipo LISTNUM conforme definido pelos respetivos códigos de campo (Parte 1, {17.16.5), esta propriedade será ignorada.

[Exemplo: considere o seguinte parágrafo que contém um único campo LISTNUM , da seguinte forma:

5ccbfcbb-0568-4f98-b9e6-bc9b07df5295

Se outro campo LISTNUM for adicionado antes do mesmo no documento, o que resulta na avaliação para um número diferente, da seguinte forma:

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

Esta revisão para o resultado do campo seria armazenada da seguinte forma no 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" />  

O elemento numberingChange especifica que a numeração resultante deste campo LISTNUM foi modificada e esta alteração foi registada como uma revisão. O resultado de numeração anterior de 1. é colocado em cache no atributo original. exemplo final]

Para campos de numeração, o atributo original deve especificar a numeração anterior apresentada pelo campo LISTNUM principal num documento do WordprocessingML. Estas informações são uma cache que melhora o desempenho do estado da numeração antes da revisão para permitir que as aplicações mostrem o estado anterior sem terem de recalcular todos os campos LISTNUM no documento.

Se este atributo for omitido, nenhum valor de numeração anterior está implícito e as aplicações podem optar por calcular este valor ou não apresentar nenhum valor de numeração anterior.

[Exemplo: considere o seguinte parágrafo que contém um único campo LISTNUM com uma revisão, da seguinte forma:

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

Esta revisão para o resultado do campo seria armazenada da seguinte forma no WordprocessingML:

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

O atributo original especifica que o valor de numeração anterior do campo era 1.exemplo final]

Elementos pai
fldChar (Parte 1, {17.16.18)

[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_TrackChangeNumbering) está localizada em {A.1. nota de fim]

[ISO/IEC 29500-1 1st Edition]

numberingChange (Previous Paragraph Numbering Properties)

Este elemento especifica o estado anterior da numeração num parágrafo quando as revisões estão a ser controladas.

[Lógica: este mecanismo é simplesmente utilizado para fornecer armazenamento para revisões à numeração produzidas por aplicações de processamento de palavras legadas e as aplicações são encorajadas a utilizar o elemento pPrChange para armazenar estas alterações como alterações às propriedades do parágrafo. end rationale]

[Exemplo: considere a seguinte lista com numerais árabes como numeração, da seguinte forma:

f1e61028-5796-4a3c-aaeb-f786fa603b64

Considere uma revisão em que a definição de numeração é alterada de numerais árabes para numerais romanos, da seguinte forma:

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

Esta revisão para a definição de numeração seria armazenada da seguinte forma no 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>  

O elemento numberingChange especifica que a definição de numeração foi modificada e esta alteração foi monitorizada como uma revisão. A definição de numeração numeral árabe anterior é colocada em cache no atributo original. exemplo final]

Para numeração de parágrafos, o atributo original deve especificar a definição de numeração anterior para um parágrafo individual de texto num documento wordprocessingML enquanto as revisões estão a ser controladas.

O valor original é representado como definições de nível de numeração separadas definidas da seguinte forma:

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

em que

• nível de numeração – o nível para o qual a definição de numeração é definida

• valor nfc – o valor do estilo de numeração no nível de numeração específico

• formato de numeração – o valor nfc do formato de numeração, conforme referenciado na tabela abaixo.

• separador – o separador utilizado para separar as definições de nível de numeração

Os valores do formato de numeração são mapeados da seguinte forma:

valor nfc

ST_NumberFormat enumeração equivalente

0

decimal

1

upperRoman

2

lowerRoman

3

upperLetter

4

lowerLetter

5

ordinal

6

cardinalText

7

ordinalText

8

hexadecim

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

marca de lista

24

ganada

25

chosung

26

decimalEnclosedFullstop

27

decimalEnclosedParen

28

decimalEnclosedCircleChinese

29

ideographEnclosedCircle

30

ideographTraditional

31

ideographZodiac

32

ideographZodiacTraditional

33

taiwanêsCounting

34

ideographLegalTraditional

35

taiwanêsCountingThousand

36

taiwanêsDigital

37

chineseCounting

38

chineseLegalSimplified

39

chineseCountingThousand

40

Definido pela aplicação. Pode ser ignorado.

41

koreanDigital

42

koreanCounting

43

koreanLegal

44

koreanDigital2

45

hebraico1

46

arabicAlpha

47

hebraico2

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

Definido pela aplicação. Pode ser ignorado.

[Exemplo: considere o seguinte parágrafo numerado em que a definição de numeração foi alterada enquanto as revisões estão a ser controladas, da seguinte forma:

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

Esta revisão para o parágrafo numerado seria armazenada da seguinte forma no WordprocessingML:

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

No exemplo acima, existem três níveis na definição de numeração original, pelo que são necessárias três definições de nível de numeração para representar a definição de numeração original.

O primeiro nível é especificado por %1 e indica que era o valor numérico 1 no formato nfc 0 (árabe).

O atributo original especifica que a definição de numeração anterior era composta por três níveis cujo valor era 1.i.1..exemplo final]

Elementos pai
numPr (Parte 1, {17.3.1.19)

[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_TrackChangeNumbering) está localizada em {A.1. nota de fim]

ISO/IEC29500: 2008.

Construtores

NumberingChange()

Inicializa uma nova instância da classe NumberingChange.

Propriedades

Author	autor Representa o seguinte atributo no esquema: w:author
ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
Date	data Representa o seguinte atributo no esquema: w:date
DateUtc	dateUtc, esta propriedade só está disponível no Microsoft365 e posterior. Representa o seguinte atributo no esquema: w16du:dateUtc
ExtendedAttributes	Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
HasAttributes	Obtém um valor que indica se o elemento atual tem atributos. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem elementos subordinados. (Herdado de OpenXmlLeafElement)
Id	Identificador de Anotação Representa o seguinte atributo no esquema: w:id
InnerText	Obtém ou define os valores concatenados do nó e de todos os respetivos subordinados. (Herdado de OpenXmlElement)
InnerXml	Obtém ou define a marcação que representa apenas elementos subordinados do elemento atual. (Herdado de OpenXmlLeafElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
Original	Original Representa o seguinte atributo no esquema: w:original
OuterXml	Obtém a marcação que representa o elemento atual e todos os respetivos elementos subordinados. (Herdado de OpenXmlElement)
Parent	Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo de espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement)
Clone()	Cria um duplicado do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria um duplicado deste nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento subordinado no tipo T. (Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado na lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual aparece depois de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo do espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Remova todos os elementos subordinados do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento subordinado especificado da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um elemento subordinado por outro elemento subordinado na lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Propriedades de Numeração de Parágrafos Anteriores. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é w:numberingChange. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)