NumberingChange Classe

Definição

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Propriedades de numeração de parágrafo anteriores.

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

Quando o objeto é serializado como xml, seu 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)

Esse elemento especifica o estado anterior da numeração exibida por um campo LISTNUM (Parte 1, §17.16.5.33) em um documento WordprocessingML quando campos LISTNUM adicionais são adicionados e as revisões estão sendo rastreadas.

[Justificativa: o mecanismo de numeração herdado fornecido pelo campo LISTNUM depende da 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 esse motivo, esses campos devem armazenar seu estado anterior como um tipo de revisão exclusivo no caractere de campo do campo de numeração. Fim da lógica]

Se esse elemento for fornecido para um campo que não seja do tipo LISTNUM , conforme definido por seus códigos de campo (Parte 1, §17.16.5), essa propriedade será ignorada.

[Exemplo: considere o seguinte parágrafo contendo um único campo LISTNUM , da seguinte maneira:

5ccbfcbb-0568-4f98-b9e6-bc9b07df5295

Se outro campo LISTNUM for adicionado antes dele no documento, resultando em sua avaliação para um número diferente, da seguinte maneira:

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

Essa revisão para o resultado do campo seria armazenada da seguinte maneira 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 desse campo LISTNUM foi modificada e essa alteração foi controlada como uma revisão. O resultado da numeração anterior de 1. é armazenado em cache no atributo original. exemplo de término]

Para campos de numeração, o atributo original deve especificar a numeração anterior exibida pelo campo LISTNUM pai em um documento WordprocessingML. Essas informações são um cache de melhoria de desempenho do estado da numeração antes da revisão para permitir que os aplicativos mostrem o estado anterior sem ter que recalcular todos os campos LISTNUM no documento.

Se esse atributo for omitido, nenhum valor de numeração anterior será implícito e os aplicativos poderão optar por calcular esse valor ou não exibir nenhum valor de numeração anterior.

[Exemplo: considere o seguinte parágrafo contendo um único campo LISTNUM com uma revisão, da seguinte maneira:

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

Essa revisão para o resultado do campo seria armazenada da seguinte maneira 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 de término]

Elementos pai
fldChar (Parte 1, §17.16.18)

[Observação: a definição do esquema XML do W3C do modelo de conteúdo (CT_TrackChangeNumbering) desse elemento está localizada em §A.1. nota final]

[ISO/IEC 29500-1 1st Edition]

numberingChange (Previous Paragraph Numbering Properties)

Esse elemento especifica o estado anterior da numeração em um parágrafo quando as revisões estão sendo controladas.

[Justificativa: esse mecanismo é simplesmente usado para fornecer armazenamento para revisões de numeração produzidas por aplicativos legados de processamento de texto, e os aplicativos são incentivados a usar o elemento pPrChange para armazenar essas alterações como alterações nas propriedades do parágrafo. Fim da lógica]

[Exemplo: considere a seguinte lista usando algarismos arábicos como numeração, da seguinte maneira:

f1e61028-5796-4a3c-aaeb-f786fa603b64

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

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

Essa revisão para a definição de numeração seria armazenada da seguinte maneira 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 essa alteração foi controlada como uma revisão. A definição anterior de numeração de algarismos arábicos é armazenada em cache no atributo original. exemplo de término]

Para numeração de parágrafo, o atributo original deve especificar a definição de numeração anterior para um parágrafo individual de texto em um documento WordprocessingML enquanto as revisões estão sendo rastreadas.

O valor do 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

• numbering level – 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.

• separator – O separador usado 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 equivalente de enumeração

0

decimal

1

upperRoman

2

lowerRoman

3

upperLetter

4

lowerLetter

5

Ordinal

6

cardinalText

7

ordinalText

8

Hex

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

marcador

24

GANADA

25

escolhido

26

decimalEnclosedFullstop

27

decimalEnclosedParen

28

decimalEnclosedCircleChinese

29

ideographEnclosedCircle

30

ideographTraditional

31

ideographZodiac

32

ideographZodiacTraditional

33

taiwanêsContagem

34

ideographLegalTraditional

35

taiwaneseCountingThousand

36

taiwanêsDigital

37

chineseCounting

38

chineseLegalSimplified

39

chineseCountingThousand

40

Definido pelo aplicativo. Pode ser ignorada.

41

coreanoDigital

42

koreanCounting

43

coreanoLegal

44

koreanDigital2

45

Hebraico1

46

ÁrabeAlfa

47

Hebraico2

48

árabeAbjad

49

hindiVogais

50

hindiConsoantes

51

hindiNumbers

52

hindiCounting

53

thaiLetters

54

thaiNumbers

55

thaiCounting

56

vietnamitaContagem

57

numberInDash

58

russianLower

59

russianUpper

60 ou superior

Definido pelo aplicativo. Pode ser ignorada.

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

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

Essa revisão para o parágrafo numerado seria armazenada da seguinte maneira 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, portanto, três definições de nível de numeração são necessárias para representar a definição de numeração original.

O primeiro nível é especificado por %1 e diz que era o valor de número 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 de término]

Elementos pai
numPr (Parte 1, §17.3.1.19)

[Observação: a definição do esquema XML do W3C do modelo de conteúdo (CT_TrackChangeNumbering) desse elemento está localizada em §A.1. nota final]

ISO/IEC29500: 2008.

Construtores

Nome	Description
NumberingChange()	Inicializa uma nova instância da classe NumberingChange.

Propriedades

Nome	Description
Author	autor Representa o seguinte atributo no esquema: w:author
ChildElements	Obtém todos os nós filhos 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 estendidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro filho do elemento OpenXmlElement. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
HasAttributes	Obtém um valor que indica se o elemento atual tem algum atributo. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem algum elemento filho. (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 seus filhos. (Herdado de OpenXmlElement)
InnerXml	Obtém ou define a marcação que representa apenas elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
LastChild	Obtém o último filho do elemento OpenXmlElement. Retorna null (Nothing no Visual Basic) se não existe 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 marcação. Retorna null se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de namespace definidas no elemento atual. Retorna um enumerador vazio se não houver nenhuma declaração de namespace. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do namespace do elemento atual. (Herdado de OpenXmlElement)
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
Original	Compartilhar Representa o seguinte atributo no esquema: w:original
OuterXml	Obtém a marcação que representa o elemento atual e todos os seus elementos filho. (Herdado de OpenXmlElement)
Parent	Obtém o elemento pai do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo do namespace 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

Nome	Description
AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado 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 final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Anexa o elemento especificado ao final da lista de nós filhos do elemento atual. (Herdado de OpenXmlElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement)
Clone()	Cria uma duplicata do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria uma duplicata desse nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumere todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os filhos do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os filhos do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da marca especificado e o URI do namespace. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento filho 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 filho 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 após 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 namespace no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de namespace no escopo do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver próximo OpenXmlElement. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual de seu pai. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Remova todos os elementos filho 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 filho especificado da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de namespace para o prefixo especificado. Não removerá nada se não houver prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um elemento filho por outro elemento filho na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento. Se um atributo for conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Salva o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

Nome	Description
IEnumerable.GetEnumerator()	Propriedades de numeração de parágrafo anteriores. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é w:numberingChange. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)