Style Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Wordprocessing

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Definición de estilo.

Esta clase está disponible en Office 2007 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es w:style.

public class Style : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Style = class
    inherit OpenXmlCompositeElement

Public Class Style
Inherits OpenXmlCompositeElement

Herencia

Object

OpenXmlElement

OpenXmlCompositeElement

Style

Ejemplos

En el ejemplo de código siguiente se abre un archivo de procesamiento de texto que contiene texto y se aplica el estilo "Título 1" al primer párrafo.

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  

Comentarios

[ISO/IEC 29500-1 1.ª edición]

style (Definición de estilo)

Este elemento especifica la definición de un único estilo dentro de un documento WordprocessingML. Un estilo es un conjunto predefinido de propiedades de tabla, numeración, párrafo o carácter que se pueden aplicar a las regiones de un documento.

La definición de estilo de cualquier definición de estilo se puede dividir en tres segmentos:

• Propiedades de estilo general

• Tipo de estilo

• Propiedades específicas del tipo de estilo

Las propiedades de estilo general hacen referencia al conjunto de propiedades que se pueden usar independientemente del tipo de estilo; por ejemplo, el nombre del estilo, alias adicionales para el estilo, un identificador de estilo (utilizado por el contenido del documento para hacer referencia al estilo), si el estilo está oculto, si el estilo está bloqueado, etc.

[Ejemplo: considere la posibilidad de usar un estilo denominado Encabezado de un documento como se indica a continuación:

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

Encima de la información de formato específica de este tipo de estilo hay un conjunto de propiedades de estilo generales que definen la información compartida por todos los tipos de estilo. Fin del ejemplo]

Tipos de estilo se refiere a la propiedad en un estilo que define el tipo de estilo creado con esta definición de estilo. WordprocessingML admite seis tipos de definiciones de estilo mediante los valores para el atributo de tipo de definición de estilo:

• Estilos de párrafo

• Estilos de carácter

• Estilos vinculados (párrafo + carácter) [Nota: se consigue mediante el elemento de vínculo (§17.7.4.6). fin de nota]

• Estilos de tabla

• Estilos de numeración

• Párrafo predeterminado + propiedades de carácter

[Ejemplo: considere la posibilidad de usar un estilo denominado Encabezado de un documento como se indica a continuación:

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

El atributo type tiene un valor de párrafo, que indica que la siguiente definición de estilo es un estilo de párrafo. Fin del ejemplo]

Las propiedades específicas del tipo de estilo hacen referencia a la carga del estilo: su información de formato, así como las propiedades que se aplican solo a ese tipo de estilo.

[Ejemplo: considere la posibilidad de un estilo de tabla con el nombre principal Normal Table definido como sigue:

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

El elemento tblPr contiene la carga de formato de este estilo de tabla, que solo es aplicable a un estilo de tabla. Fin del ejemplo]

Elementos primarios
styles (§17.7.4.18)

Elementos secundarios	Subclause
alias (nombres de estilo alternativos)	§17.7.4.1
autoRedefine (combinar automáticamente el formato de usuario en la definición de estilo)	§17.7.4.2
basedOn (identificador de estilo primario)	§17.7.4.3
hidden (Ocultar estilo de la interfaz de usuario)	§17.7.4.4
link (Referencia de estilo vinculado)	§17.7.4.6
bloqueado (no se puede aplicar el estilo)	§17.7.4.7
name (Nombre de estilo principal)	§17.7.4.9
siguiente (estilo para el párrafo siguiente)	§17.7.4.10
personal (estilo de texto de mensaje de correo electrónico)	§17.7.4.11
personalCompose (estilo de composición de mensajes de correo electrónico)	§17.7.4.12
personalReply (estilo de respuesta de mensaje de correo electrónico)	§17.7.4.13
pPr (propiedades de párrafo de estilo)	§17.7.8.2
qFormat (estilo principal)	§17.7.4.14
rPr (propiedades de ejecución)	§17.7.9.1
rsid (identificador de revisión para la definición de estilo)	§17.7.4.15
semiHidden (Ocultar estilo de la interfaz de usuario principal)	§17.7.4.16
tblPr (propiedades de tabla de estilo)	§17.7.6.4
tblStylePr (Propiedades de formato de tabla condicional de estilo)	§17.7.6.6
tcPr (propiedades de celda de tabla de estilos)	§17.7.6.9
trPr (propiedades de fila de tabla de estilo)	§17.7.6.11
uiPriority (orden opcional de ordenación de la interfaz de usuario)	§17.7.4.19
unhideWhenUsed (Quitar Semi-Hidden propiedad cuando se usa style)	§17.7.4.20

[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_Style) se encuentra en §A.1. Fin de la nota]

ISO/IEC29500: 2008.

Constructores

Style()	Inicializa una nueva instancia de la clase Style.
Style(IEnumerable<OpenXmlElement>)	Inicializa una nueva instancia de la clase Style con los elementos secundarios especificados.
Style(OpenXmlElement[])	Inicializa una nueva instancia de la clase Style con los elementos secundarios especificados.
Style(String)	Inicializa una nueva instancia de la clase Style a partir de XML externo.

Propiedades

Aliases	Nombres de estilo alternativos. Representa la siguiente etiqueta de elemento en el esquema: w:aliases.
AutoRedefine	Combine automáticamente el formato de usuario en la definición de estilo. Representa la siguiente etiqueta de elemento en el esquema: w:autoRedefine.
BasedOn	Id. de estilo primario. Representa la siguiente etiqueta de elemento en el esquema: w:basedOn.
ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
CustomStyle	Estilo User-Defined Representa el atributo siguiente en el esquema: w:customStyle
Default	Estilo predeterminado Representa el atributo siguiente en el esquema: w:default
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement actual. (Heredado de OpenXmlCompositeElement)
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlCompositeElement)
InnerText	Obtiene o establece los valores concatenados del nodo actual y todos sus elementos secundarios. (Heredado de OpenXmlCompositeElement)
InnerXml	Obtiene o establece el marcado que representa solo los nodos secundarios del nodo actual. (Heredado de OpenXmlCompositeElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlCompositeElement)
LinkedStyle	Referencia de estilo vinculado. Representa la siguiente etiqueta de elemento en el esquema: w:link.
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
Locked	No se puede aplicar el estilo. Representa la siguiente etiqueta de elemento en el esquema: w:locked.
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
NextParagraphStyle	Estilo para el párrafo siguiente. Representa la siguiente etiqueta de elemento en el esquema: w:next.
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Personal	Estilo de texto de mensaje de correo electrónico. Representa la siguiente etiqueta de elemento en el esquema: w:personal.
PersonalCompose	Estilo de composición de mensajes de correo electrónico. Representa la siguiente etiqueta de elemento en el esquema: w:personalCompose.
PersonalReply	Estilo de respuesta de mensaje de correo electrónico. Representa la siguiente etiqueta de elemento en el esquema: w:personalReply.
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
PrimaryStyle	Estilo principal. Representa la siguiente etiqueta de elemento en el esquema: w:qFormat.
Rsid	Identificador de revisión para la definición de estilo. Representa la siguiente etiqueta de elemento en el esquema: w:rsid.
SemiHidden	Ocultar el estilo de la interfaz de usuario principal. Representa la siguiente etiqueta de elemento en el esquema: w:semiHidden.
StyleHidden	Ocultar el estilo de la interfaz de usuario. Representa la siguiente etiqueta de elemento en el esquema: w:hidden.
StyleId	Id. de estilo Representa el atributo siguiente en el esquema: w:styleId
StyleName	Nombre del estilo principal. Representa la siguiente etiqueta de elemento en el esquema: w:name.
StyleParagraphProperties	Propiedades de párrafo de estilo. Representa la siguiente etiqueta de elemento en el esquema: w:pPr.
StyleRunProperties	Ejecutar propiedades. Representa la siguiente etiqueta de elemento en el esquema: w:rPr.
StyleTableCellProperties	Propiedades de celda de tabla de estilos. Representa la siguiente etiqueta de elemento en el esquema: w:tcPr.
StyleTableProperties	Propiedades de tabla de estilo. Representa la siguiente etiqueta de elemento en el esquema: w:tblPr.
TableStyleConditionalFormattingTableRowProperties	Propiedades de fila de tabla de estilo. Representa la siguiente etiqueta de elemento en el esquema: w:trPr.
Type	Tipo de estilo Representa el atributo siguiente en el esquema: w:type
UIPriority	Orden opcional de la interfaz de usuario. Representa la siguiente etiqueta de elemento en el esquema: w:uiPriority.
UnhideWhenUsed	Quite Semi-Hidden propiedad cuando se use style. Representa la siguiente etiqueta de elemento en el esquema: w:unhideWhenUsed.
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Agrega el elemento especificado al elemento si es un elemento secundario conocido. Esto agrega el elemento en la ubicación correcta según el esquema. (Heredado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado de los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado. (Heredado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza uno de los elementos secundarios del elemento actual por otro elemento OpenXmlElement. (Heredado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()	Definición de estilo. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es w:style. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)