Style Classe

Definição

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Definição de estilo.

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

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

public class Style : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Style = class
    inherit OpenXmlCompositeElement

Public Class Style
Inherits OpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

Style

Exemplos

O exemplo de código a seguir abre um arquivo de processamento de palavras que contém algum texto e aplica o estilo "Título 1" ao primeiro parágrafo.

using System;  
using System.Linq;  
using DocumentFormat.OpenXml.Packaging;  
using DocumentFormat.OpenXml.Wordprocessing;  

namespace StyleEx  
{  
    class Program  
    {  
        // Apply the Heading 1 style to a paragraph.  
        static void Main(string[] args)  
        {  
            string fileName = @"C:\users\public\documents\StyleEx.docx";  

            using (WordprocessingDocument document =   
                WordprocessingDocument.Open(fileName, true))  
            {  
                // Get the first paragraph.  
                Paragraph p =  
                    document.MainDocumentPart.Document.Body.Elements<Paragraph>().First();  

                // If the paragraph has no ParagraphProperties objects, create a new one for it.  
                if (p.Elements<ParagraphProperties>().Count() == 0)  
                {  
                    p.PrependChild<ParagraphProperties>(new ParagraphProperties());  
                }  

                // Get the paragraph properties element of the paragraph.  
                ParagraphProperties pPr = p.Elements<ParagraphProperties>().First();  

                // Set the paragraph style ID to "Heading1".  
                pPr.ParagraphStyleId = new ParagraphStyleId() { Val = "Heading1" };                
            }  
        }  
    }  
}  

Imports System.Linq  
Imports DocumentFormat.OpenXml.Wordprocessing  
Imports DocumentFormat.OpenXml.Packaging  

Module Module1  
    ' Apply the Heading 1 style to a paragraph.  
    Sub Main()  
        Dim fileName As String = "C:\Users\Public\Documents\StyleEx.docx"  

        Using doc As WordprocessingDocument = _  
            WordprocessingDocument.Open(fileName, True)  
            ' Get the first paragraph.  
            Dim p As Paragraph = doc.MainDocumentPart.Document.Body.Elements _  
                (Of Paragraph).First()  

            ' If the paragraph has no ParagraphProperties objects, create a new one for it.  
            If p.Elements(Of ParagraphProperties).Count() = 0 Then  
                p.PrependChild(Of ParagraphProperties)(New ParagraphProperties())  
            End If  

            ' Get the paragraph properties element of the paragraph.  
            Dim pPr As ParagraphProperties = p.Elements(Of ParagraphProperties).First()  

            ' Set the paragraph style ID to "Heading1".  
            pPr.ParagraphStyleId = New ParagraphStyleId() With {.Val = "Heading1"}  
        End Using  
    End Sub  
End Module  

Comentários

[ISO/IEC 29500-1 1st Edition]

style (Definição de estilo)

Esse elemento especifica a definição de um único estilo dentro de um documento wordprocessingML. Um estilo é um conjunto predefinido de propriedades de tabela, numeração, parágrafo e/ou caractere que podem ser aplicadas a regiões dentro de um documento.

A definição de estilo para qualquer definição de estilo pode ser dividida em três segmentos:

• Propriedades de estilo geral

• Tipo de estilo

• Propriedades específicas do tipo de estilo

As propriedades de estilo geral referem-se ao conjunto de propriedades que podem ser usadas independentemente do tipo de estilo; por exemplo, o nome do estilo, aliases adicionais para o estilo, uma ID de estilo (usada pelo conteúdo do documento para se referir ao estilo), se o estilo estiver oculto, se o estilo estiver bloqueado etc.

[Exemplo: considere um estilo chamado Título de documento da seguinte maneira:

<w:style w:type="paragraph" w:styleId="Heading1">  
  <w:name w:val="Heading 1"/>  
  <w:basedOn w:val="Normal"/>  
  <w:next w:val="Normal"/>  
  <w:link w:val="Heading1Char"/>  
  <w:uiPriority w:val="1"/>  
  <w:qformat/>  
  <w:rsid w:val="00F303CE"/>  
  …</w:style>  

Acima das informações de formatação específicas para esse tipo de estilo estão um conjunto de propriedades de estilo geral que definem informações compartilhadas por todos os tipos de estilo. exemplo final]

Tipos de estilo referem-se à propriedade em um estilo que define o tipo de estilo criado com essa definição de estilo. WordprocessingML dá suporte a seis tipos de definições de estilo pelos valores para o atributo de tipo da definição de estilo:

• Estilos de parágrafo

• Estilos de caractere

• Estilos vinculados (parágrafo + caractere) [Observação: realizado por meio do elemento link (§17.7.4.6). nota final]

• Table styles

• Estilos de numeração

• Parágrafo padrão + propriedades de caractere

[Exemplo: considere um estilo chamado Título de documento da seguinte maneira:

<w:style w:type="paragraph" w:styleId="Heading1">  
  <w:name w:val="heading 1"/>  
  <w:basedOn w:val="Normal"/>  
  <w:next w:val="Normal"/>  
  <w:link w:val="Heading1Char"/>  
  <w:uiPriority w:val="1"/>  
  <w:qformat/>  
  <w:rsid w:val="00F303CE"/>  
  …</w:style>  

O atributo de tipo tem um valor de parágrafo, o que indica que a definição de estilo a seguir é um estilo de parágrafo. exemplo final]

Propriedades específicas do tipo de estilo referem-se à carga do estilo: suas informações de formatação, bem como quaisquer propriedades que se aplicam apenas a esse tipo de estilo.

[Exemplo: considere um estilo de tabela com o nome primário Tabela Normal definida da seguinte maneira:

<w:style w:type="table" w:default="1" w:styleId="TableNormal">  
  <w:name w:val="Normal Table"/>  
  …  <w:tblPr>  
    <w:tblInd w:w="0" w:type="dxa"/>  
    <w:tblCellMar>  
      <w:top w:w="0" w:type="dxa"/>  
      <w:left w:w="108" w:type="dxa"/>  
      <w:bottom w:w="0" w:type="dxa"/>  
      <w:right w:w="108" w:type="dxa"/>  
    </w:tblCellMar>  
  </w:tblPr>  
</w:style>  

O elemento tblPr contém a carga de formatação para este estilo de tabela, que só é aplicável a um estilo de tabela. exemplo final]

Elementos pai
estilos (§17.7.4.18)

Elementos filho	Subclause
aliases (nomes de estilo alternativos)	§17.7.4.1
autoRedefine (mesclar automaticamente formatação de usuário em definição de estilo)	§17.7.4.2
basedOn (ID de estilo pai)	§17.7.4.3
oculto (Ocultar estilo da interface do usuário)	§17.7.4.4
link (Referência de estilo vinculado)	§17.7.4.6
bloqueado (o estilo não pode ser aplicado)	§17.7.4.7
nome (Nome do estilo primário)	§17.7.4.9
próximo (Style For Next Paragraph)	§17.7.4.10
pessoal (estilo de texto de mensagem de email)	§17.7.4.11
personalCompose (estilo de composição de mensagem de email)	§17.7.4.12
personalReply (estilo de resposta de mensagem de email)	§17.7.4.13
pPr (propriedades do parágrafo de estilo)	§17.7.8.2
qFormat (estilo primário)	§17.7.4.14
rPr (Propriedades de Execução)	§17.7.9.1
rsid (Identificador de Revisão para Definição de Estilo)	§17.7.4.15
semiHidden (ocultar estilo da interface principal do usuário)	§17.7.4.16
tblPr (propriedades da tabela de estilo)	§17.7.6.4
tblStylePr (propriedades de formatação de tabela condicional de estilo)	§17.7.6.6
tcPr (propriedades de célula de tabela de estilo)	§17.7.6.9
trPr (propriedades da linha de tabela de estilo)	§17.7.6.11
uiPriority (ordem de classificação de interface do usuário opcional)	§17.7.4.19
unhideWhenUsed (Remover Semi-Hidden propriedade quando o estilo é usado)	§17.7.4.20

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

ISO/IEC29500: 2008.

Construtores

Style()	Inicializa uma nova instância da classe Style.
Style(IEnumerable<OpenXmlElement>)	Inicializa uma nova instância da classe Style com os elementos filho especificados.
Style(OpenXmlElement[])	Inicializa uma nova instância da classe Style com os elementos filho especificados.
Style(String)	Inicializa uma nova instância da classe Style do XML externo.

Propriedades

Aliases	Nomes de estilo alternativos. Representa a seguinte marca de elemento no esquema: w:aliases.
AutoRedefine	Mesclar automaticamente a formatação de usuário na definição de estilo. Representa a seguinte marca de elemento no esquema: w:autoRedefine.
BasedOn	ID de estilo pai. Representa a seguinte marca de elemento no esquema: w:basedOn.
ChildElements	Obtém todos os nós filho do elemento atual. (Herdado de OpenXmlElement)
CustomStyle	estilo User-Defined Representa o seguinte atributo no esquema: w:customStyle
Default	Estilo Padrão Representa o seguinte atributo no esquema: w:default
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 atual. (Herdado de OpenXmlCompositeElement)
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 filho. (Herdado de OpenXmlCompositeElement)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os seus filhos. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós filho do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último filho do elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
LinkedStyle	Referência de estilo vinculado. Representa a seguinte marca de elemento no esquema: w:link.
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
Locked	O estilo não pode ser aplicado. Representa a seguinte marca de elemento no esquema: w:locked.
MCAttributes	Obtém ou define os atributos de compatibilidade de marcação. Retorna nulo 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. Retornará 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)
NextParagraphStyle	Estilo para o próximo parágrafo. Representa a seguinte marca de elemento no esquema: w:next.
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
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)
Personal	Estilo de texto de mensagem de email. Representa a seguinte marca de elemento no esquema: w:personal.
PersonalCompose	Estilo de composição de mensagem de email. Representa a seguinte marca de elemento no esquema: w:personalCompose.
PersonalReply	Estilo de resposta de mensagem de email. Representa a seguinte marca de elemento no esquema: w:personalReply.
Prefix	Obtém o prefixo namespace do elemento atual. (Herdado de OpenXmlElement)
PrimaryStyle	Estilo primário. Representa a seguinte marca de elemento no esquema: w:qFormat.
Rsid	Identificador de revisão para definição de estilo. Representa a seguinte marca de elemento no esquema: w:rsid.
SemiHidden	Ocultar estilo da interface principal do usuário. Representa a seguinte marca de elemento no esquema: w:semiHidden.
StyleHidden	Ocultar estilo da interface do usuário. Representa a seguinte marca de elemento no esquema: w:hidden.
StyleId	ID de estilo Representa o seguinte atributo no esquema: w:styleId
StyleName	Nome do estilo primário. Representa a seguinte marca de elemento no esquema: w:name.
StyleParagraphProperties	Propriedades do parágrafo style. Representa a seguinte marca de elemento no esquema: w:pPr.
StyleRunProperties	Executar Propriedades. Representa a seguinte marca de elemento no esquema: w:rPr.
StyleTableCellProperties	Propriedades de célula de tabela de estilo. Representa a seguinte marca de elemento no esquema: w:tcPr.
StyleTableProperties	Propriedades da Tabela de Estilos. Representa a seguinte marca de elemento no esquema: w:tblPr.
TableStyleConditionalFormattingTableRowProperties	Propriedades da linha de tabela de estilo. Representa a seguinte marca de elemento no esquema: w:trPr.
Type	Tipo de estilo Representa o seguinte atributo no esquema: w:type
UIPriority	Ordem de classificação de interface do usuário opcional. Representa a seguinte marca de elemento no esquema: w:uiPriority.
UnhideWhenUsed	Remova Semi-Hidden propriedade quando o estilo for usado. Representa a seguinte marca de elemento no esquema: w:unhideWhenUsed.
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)
AddChild(OpenXmlElement, Boolean)	Adiciona o elemento especificado ao elemento se ele for uma criança conhecida. Isso adiciona o elemento no local correto de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
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 até o final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao final da lista de nós filho do elemento atual. (Herdado de OpenXmlCompositeElement)
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>()	Enumera 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 e o URI do namespace especificados. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (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 OpenXmlCompositeElement)
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 dos filhos do elemento atual. (Herdado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual é exibido após um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual é exibido antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo 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 nulo (Nada 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. Retornará nulo (Nada no Visual Basic) se não houver o próximo OpenXmlElement. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós filho do elemento atual. (Herdado de OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
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. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de namespace do prefixo especificado. Não removerá nada se não houver nenhum prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos filho do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo 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 uma série de atributos para o elemento. Se um atributo for um atributo 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

IEnumerable.GetEnumerator()	Definição de estilo. Essa classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é w:style. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)