Estructura de un documento PresentationML

Artículo
11/16/2023

La estructura del documento de un documento PresentationML consta del elemento presentation><(Presentation) que contiene <los elementos sldMaster> (Patrón de diapositivas), <sldLayout> (Diseño de diapositivas), <sld > (Diapositiva) y <Tema> (Tema) que hacen referencia a las diapositivas de la presentación. (El elemento Theme es el elemento raíz de la parte DrawingMLTheme). Estos elementos son los elementos mínimos necesarios para un documento de presentación válido.

Además, un documento de presentación puede contener <notas> (diapositiva de notas), <handoutMaster> (patrón de entrega), <sp> (forma), <imagen> (imagen), <tbl> (tabla) y otros elementos relacionados con diapositivas. (Los elementos Table se definen en el esquema DrawingML).

Un documento PresentationML puede incluir otras características, como animación, audio, vídeo y transiciones entre las diapositivas.

Los documentos PresentationML no se almacenan como un gran cuerpo en una sola parte. En su lugar, los elementos que implementan ciertas agrupaciones de funcionalidades se almacenan en partes independientes. Por ejemplo, todos los comentarios de un documento se almacenan en una parte de comentarios mientras que cada diapositiva cuenta con su propia parte. Se crea un archivo XML independiente para cada diapositiva.

Partes de presentación importantes

Con el SDK de Open XML, puede crear la estructura de documentos y el contenido que usa clases fuertemente tipadas que corresponden a elementos PresentationML. Puede encontrar estas clases en el espacio de nombres DocumentFormat.OpenXml.Presentation . En la tabla siguiente se enumeran los nombres de las clases que corresponden a algunos de los elementos más importantes de la presentación.

Parte de paquete	Elemento de PresentationML de nivel superior	Open XML SDK (clase)	Description*
Presentación	<presentación>	Presentation	El elemento raíz de la parte de presentación. Este elemento especifica las propiedades fundamentales para toda la presentación.
Propiedades de la presentación	<presentationPr>	PresentationProperties	El elemento raíz de la parte de propiedades de presentación. Este elemento funciona como un elemento primario en el que se incluyen propiedades adicionales para toda la presentación.
Patrón de diapositivas	<sldMaster>	SlideMaster	El elemento raíz de la parte de patrón de diapositivas. En un elemento de patrón de diapositivas se incluyen todos los elementos que describen los objetos y su formato correspondiente dentro de una diapositiva de presentación. Para obtener más información, vea Trabajar con patrones de diapositivas.
Diseño de diapositiva	<sldLayout>	SlideLayout	El elemento raíz de la parte de diseño de diapositiva. Este elemento especifica la información de relación de cada diseño de diapositiva usado en el patrón de diapositivas. Para obtener más información, vea Trabajar con diseños de diapositivas.
Tema	<officeStyleSheet>	Theme	El elemento raíz de la parte de tema. Este elemento contiene todas las distintas opciones de formato disponibles para un documento mediante un tema y define la apariencia general del documento cuando en él se usan objetos temáticos.
Slide	<Sld>	Slide	El elemento raíz de la parte de diapositiva. Este elemento especifica una diapositiva de una lista de diapositivas. Para obtener más información, vea Trabajar con diapositivas de presentación.
Patrón de notas	<notesMaster>	NotesMaster	El elemento raíz de la parte de patrón de notas. En una parte de patrón de notas se incluyen todos los elementos que describen los objetos y su formato correspondiente dentro de una diapositiva de notas.
Diapositiva de notas	<Notas>	NotesSlide	El elemento raíz de la parte de diapositiva de notas. Este elemento especifica la existencia de una diapositiva de notas junto con sus datos correspondientes. En una diapositiva de notas se incluyen todos los elementos de diapositiva comunes junto con propiedades adicionales específicas del elemento de notas. Para obtener más información, consulte Trabajar con diapositivas de notas.
Patrón de documentos	<handoutMaster>	HandoutMaster	El elemento raíz de la parte de patrón de documentos. En un elemento de patrón de documentos se incluyen todos los elementos que describen los objetos y su formato correspondiente dentro de una diapositiva de documento. Para obtener más información, consulte Trabajar con diapositivas maestras de documentos.
Comentarios	<cmLst>	CommentList	El elemento raíz de la parte de comentarios. Este elemento especifica una lista de comentarios de una diapositiva concreta. Para obtener más información, vea Trabajar con comentarios.
Autor de comentarios	<cmAuthorLst>	CommentAuthorList	El elemento raíz de la parte de autores de comentarios. Este elemento especifica una lista de autores con comentarios en el documento actual. Para obtener más información, vea Trabajar con comentarios.

*Descripciones adaptadas a la especificación ISO/IEC 29500 , © ISO/IEC29500: 2008.

Parte de presentación

La parte principal de un paquete PresentationML comienza con un <elemento raíz de presentación> . Dicho elemento contiene una presentación que, a su vez, hace referencia a una lista de diapositivas, una lista de patrones de diapositivas, una lista de patrones de notas y una lista de patrones de documentos. La lista de diapositivas hace referencia a todas las diapositivas de la presentación. La lista maestra de diapositivas hace referencia a todo el conjunto de patrones de diapositivas usados en la presentación. El patrón de notas contiene información sobre el formato de las páginas de notas. El maestro de documentos describe el aspecto de un documento. (Un documento es un conjunto impreso de diapositivas que se pueden entregar a un público para futuras referencias).

Parte de propiedades de presentación

El elemento raíz de la parte Propiedades de presentación es el <elemento presentationPr> .

La especificación ISO/IEC 29500 describe la parte de propiedades de presentación de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene todas las propiedades de la presentación.

Un paquete debe incluir exactamente una parte de propiedades de presentación, que debe ser el destino de una relación implícita a partir de la parte de presentación (§13.3.6).

Ejemplo: El siguiente elemento part-relationship presentation contiene una relación con la parte Propiedades de la presentación, que se almacena en el elemento ZIP presProps.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId6"  
        Type="https://…/presProps" Target="presProps.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser presentationPr. Ejemplo:

<p:presentationPr xmlns:p="…" …>  
    <p:clrMru>  
        …  
    </p:clrMru>  
    …  
</p:presentationPr>

Una parte de propiedades de presentación debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de propiedades de presentación no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de patrón de diapositivas

El elemento raíz de la parte patrón de diapositivas es el <elemento sldMaster> .

La especificación ISO/IEC 29500 describe el patrón de diapositivas de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene la definición de patrón del formato, el texto y los objetos que aparecen en cada diapositiva de la presentación que deriva de este patrón de diapositivas.

Un paquete debe incluir una o varias partes de patrón de diapositivas, cada una de los cuales debe ser el destino de una relación explícita a partir de la parte de presentación (§13.3.6), así como de una relación implícita a partir de cualquier parte de diseño de diapositiva (§13.3.9) donde se define dicho diseño de diapositiva en función de este patrón de diapositivas. Opcionalmente, cada una de ellas también puede ser el destino de una relación en una parte de diseño de diapositiva (§13.3.9).

Ejemplo: El siguiente elemento de relación de elementos de presentación contiene una relación con la parte patrón de diapositivas, que se almacena en el elemento ZIP slideMasters/slideMaster1.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId1"  
        Type="https://…/slideMaster"
Target="slideMasters/slideMaster1.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser sldMaster. Ejemplo:

<p:sldMaster xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld>  
    <p:clrMap … />  
</p:sldMaster>

Una parte de patrón de diapositivas debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de patrón de diapositivas puede contener relaciones implícitas con las siguientes partes definidas por ISO/IEC 29500:

Características adicionales (§15.2.1)
Bibliografía (§15.2.3)
Almacenamiento de datos XML personalizado (§15.2.4)
Tema (§14.2.7)
Miniatura (§15.2.16)

Una parte de patrón de diapositivas puede contener relaciones explícitas con las siguientes partes definidas por ISO/IEC 29500:

Audio (§15.2.2)
Gráfico (§14.2.1)
Parte de contenido (§15.2.4)
Diagramas: Colores del diagrama (§14.2.3), Datos de diagrama (§14.2.4), Definición de diseño de diagrama (§14.2.5) y Estilos de diagrama (§14.2.6)
Persistencia del control incrustado (§15.2.9)
Objeto incrustado (§15.2.10)
Paquete incrustado (§15.2.11)
Hipervínculo (§15.3)
Imagen (§15.2.14)
Diseño de diapositivas (§13.3.9)
Vídeo (§15.2.15)

Una parte de patrón de diapositivas no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de diseño de diapositiva

El elemento raíz de la parte Slide Layout es el <elemento sldLayout> .

La especificación ISO/IEC 29500 describe la parte de diseño de diapositiva de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene la definición de una plantilla de diseño de diapositiva para esta presentación. Esta plantilla define el posicionamiento y la apariencia predeterminados de los objetos de dibujo en este tipo de diapositiva al crearla.

Un paquete debe incluir una o varias partes de diseño de diapositiva, cada una de los cuales debe ser el destino de una relación explícita en la parte de patrón de diapositivas (§13.3.10), así como de una relación implícita a partir de cada una de las partes de diapositiva (§13.3.8) asociadas con este diseño de diapositiva.

Ejemplo: El siguiente elemento de relación de elementos del patrón de diapositivas contiene relaciones con varios elementos de diseño de diapositivas, que se almacenan en los elementos ZIP .. /slideLayouts/slideLayoutN.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId1"  
        Type="https://…/slideLayout"  
        Target="../slideLayouts/slideLayout1.xml"/>  
    <Relationship Id="rId2"  
        Type="https://…/slideLayout"  
        Target="../slideLayouts/slideLayout2.xml"/>  
    <Relationship Id="rId3"  
        Type="https://…/slideLayout"  
        Target="../slideLayouts/slideLayout3.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser sldLayout. Ejemplo:

<p:sldLayout xmlns:p="…" matchingName="" type="title" preserve="1">  
    <p:cSld name="Title Slide">  
        …  
    </p:cSld>  
    <p:clrMapOvr>  
        <a:masterClrMapping/>  
    </p:clrMapOvr>  
    <p:timing/>  
</p:sldLayout>

Una parte de diseño de diapositiva puede contener relaciones implícitas con las siguientes partes definidas por ISO/IEC 29500:

Características adicionales (§15.2.1)
Bibliografía (§15.2.3)
Almacenamiento de datos XML personalizado (§15.2.4)
Patrón de diapositivas (§13.3.10)
Invalidación del tema (§14.2.8)
Miniatura (§15.2.16)

Una parte de diseño de diapositiva puede contener relaciones explícitas con las siguientes partes definidas por ISO/IEC 29500:

Audio (§15.2.2)
Gráfico (§14.2.1)
Parte de contenido (§15.2.4)
Diagramas: Colores del diagrama (§14.2.3), Datos de diagrama (§14.2.4), Definición de diseño de diagrama (§14.2.5) y Estilos de diagrama (§14.2.6)
Persistencia del control incrustado (§15.2.9)
Objeto incrustado (§15.2.10)
Paquete incrustado (§15.2.11)
Hipervínculo (§15.3)
Imagen (§15.2.14)
Vídeo (§15.2.15)

Una parte de diseño de diapositiva no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de diapositiva

El elemento raíz de la parte Slide es el <elemento sld> .

Al igual que el texto y los gráficos, cada diapositiva puede incluir comentarios y notas, tener un diseño y formar parte de una o varias presentaciones personalizadas. Un comentario es una anotación dirigida a la persona que se encarga del mantenimiento de las diapositivas de la presentación. Una nota es un aviso o texto dirigido al moderador o al público.

La especificación ISO/IEC 29500 describe la parte de diapositiva de PresentationML de Office Open XML de la siguiente manera:

Una parte de diapositiva incluye el contenido de una sola diapositiva.

Un paquete debe incluir una parte de diapositiva por cada diapositiva, cada una de las cuales debe ser el destino de una relación explícita a partir de la parte de presentación (§13.3.6).

Ejemplo: considere la posibilidad de que un documento PresentationML tenga dos diapositivas. El elemento de relación de la parte de presentación correspondiente contiene dos relaciones con partes de diapositiva, almacenadas en los elementos ZIP slides/slide1.xml y slides/slide2.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId2"  
        Type="https://…/slide" Target="slides/slide1.xml"/>  
    <Relationship Id="rId3"  
        Type="https://…/slide" Target="slides/slide2.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser sld.

Ejemplo: slides/slide1.xml contiene:

<p:sld xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld>  
    <p:clrMapOvr>  
        …  
    </p:clrMapOvr>  
    <p:timing>  
        <p:tnLst>  
            <p:par>  
                <p:cTn id="1" dur="indefinite" restart="never"
nodeType="tmRoot"/>  
            </p:par>  
        </p:tnLst>  
    </p:timing>  
</p:sld>

Una parte de diapositiva debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de diapositiva puede contener relaciones implícitas con las siguientes partes definidas por ISO/IEC 29500:

Características adicionales (§15.2.1)
Bibliografía (§15.2.3)
Comentarios (§13.3.2)
Almacenamiento de datos XML personalizado (§15.2.4)
Diapositiva de notas (§13.3.5)
Invalidación del tema (§14.2.8)
Miniatura (§15.2.16)
Diseño de diapositivas (§13.3.9)
Datos de sincronización de diapositivas (§13.3.11)

Una parte de diapositiva puede contener relaciones explícitas con las siguientes partes definidas por ISO/IEC 29500:

Audio (§15.2.2)
Gráfico (§14.2.1)
Parte de contenido (§15.2.4)
Diagramas: Colores del diagrama (§14.2.3), Datos de diagrama (§14.2.4), Definición de diseño de diagrama (§14.2.5) y Estilos de diagrama (§14.2.6)
Persistencia del control incrustado (§15.2.9)
Objeto incrustado (§15.2.10)
Paquete incrustado (§15.2.11)
Hipervínculo (§15.3)
Imagen (§15.2.14)
Etiquetas definidas por el usuario (§13.3.12)
Vídeo (§15.2.15)

Una parte de diapositiva no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de tema

El elemento raíz de la parte Theme es el <elemento officeStyleSheet> .

La especificación ISO/IEC 29500 describe la parte de tema de DrawingML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene información acerca del tema de un documento, que es una mezcla de combinación de colores, combinación de fuentes y combinación de formatos (también se hace referencia a esta última como efectos). En un documento WordprocessingML, la elección del tema afecta al color y estilo de los encabezados, entre otras cosas. En un documento SpreadsheetML, la elección del tema afecta al color y estilo del contenido y los gráficos de las celdas, entre otras cosas. En un documento PresentationML, la elección del tema afecta al formato de las diapositivas, los documentos y las notas mediante el patrón asociado, entre otras cosas.

Los paquetes WordprocessingML o SpreadsheetML pueden contener una o ninguna parte de tema, que debe ser el destino de una relación implícita en una parte de documento principal (§11.3.10) o de libro (§12.3.23). Los paquetes PresentationML pueden contener una o ninguna parte de tema por parte de patrón de documentos (§13.3.3), de patrón de notas (§13.3.4), de patrón de diapositivas (§13.3.10) o de presentación (§13.3.6) mediante una relación implícita.

Ejemplo: El siguiente elemento de relación de elementos de documento principal WordprocessingML contiene una relación con el elemento Theme, que se almacena en el tema o theme1.xml del elemento ZIP:

<Relationships xmlns="…">  
    <Relationship Id="rId4"  
        Type="https://…/theme" Target="theme/theme1.xml"/>  
    </Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser officeStyleSheet.

Ejemplo: theme1.xml contiene lo siguiente, donde los atributos name de los elementos clrScheme, fontScheme y fmtScheme corresponden a la combinación de colores, la combinación de fuentes y el esquema de formato del documento, respectivamente:

<a:officeStyleSheet xmlns:a="…">  
    <a:baseStyles>  
        <a:clrScheme name="…">  
            …  
        </a:clrScheme>  
        <a:fontScheme name="…">  
            …  
        </a:fontScheme>  
        <a:fmtScheme name="…">  
            …  
        </a:fmtScheme>  
    </a:baseStyles>  
    <a:objectDefaults/>  
</a:officeStyleSheet>

Una parte de tema debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de tema puede contener relaciones explícitas con las siguientes partes definidas por ISO/IEC 29500:

Imagen (§15.2.14)

Una parte de tema no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de patrón de notas

El elemento raíz de la parte Maestro de notas es el <elemento notesMaster> .

La especificación ISO/IEC 29500 describe la parte de patrón de notas de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene información acerca del contenido y el formato de todas las páginas de notas.

Un paquete debe incluir como máximo una parte de patrón de notas, que debe ser el destino de una relación implícita a partir de la parte de diapositiva de notas (§13.3.5), así como de una relación explícita a partir de la parte de presentación (§13.3.6).

Ejemplo: El siguiente elemento de relación de elementos de presentación contiene una relación con el elemento Maestro de notas, que se almacena en el elemento ZIP notesMasters/notesMaster1.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId4"  
        Type="https://…/notesMaster"
Target="notesMasters/notesMaster1.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser notesMaster. Ejemplo:

<p:notesMaster xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld\>  
    <p:clrMap … />  
</p:notesMaster>

Una parte de patrón de notas debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de patrón de notas puede contener relaciones implícitas con las siguientes partes definidas por ISO/IEC 29500:

Características adicionales (§15.2.1)
Bibliografía (§15.2.3)
Almacenamiento de datos XML personalizado (§15.2.4)
Tema (§14.2.7)
Miniatura (§15.2.16)

Una parte de patrón de notas puede contener relaciones explícitas con las siguientes partes definidas por ISO/IEC 29500:

Audio (§15.2.2)
Gráfico (§14.2.1)
Parte de contenido (§15.2.4)
Diagramas: Colores del diagrama (§14.2.3), Datos de diagrama (§14.2.4), Definición de diseño de diagrama (§14.2.5) y Estilos de diagrama (§14.2.6)
Persistencia del control incrustado (§15.2.9)
Objeto incrustado (§15.2.10)
Paquete incrustado (§15.2.11)
Hipervínculo (§15.3)
Imagen (§15.2.14)
Vídeo (§15.2.15)

La parte de patrón de notas no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de diapositiva de notas

El elemento raíz de la parte Diapositiva de notas es el <elemento notes> .

La especificación ISO/IEC 29500 describe la parte de diapositiva de notas de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene las notas de una sola diapositiva.

Un paquete debe contener una parte de diapositiva de notas para cada diapositiva que contiene notas. Si existen, cada uno de dichos elementos debe ser el destino de una relación implícita a partir de la parte de diapositiva (§13.3.8).

Ejemplo: El siguiente elemento de relación de elementos de diapositiva contiene una relación con una parte de diapositiva de notas, que se almacena en el elemento ZIP .. /notesSlides/notesSlide1.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId3"  
        Type="https://…/notesSlide"
Target="../notesSlides/notesSlide1.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser notes. Ejemplo:

<p:notes xmlns:p="…">  
    <p:cSld name="">  
         …  
    </p:cSld>  
    <p:clrMapOvr>  
        <a:masterClrMapping/>  
    </p:clrMapOvr>  
</p:notes>

Una parte de diapositiva de notas debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de diapositiva de notas puede contener relaciones implícitas con las siguientes partes definidas por ISO/IEC 29500:

Características adicionales (§15.2.1)
Bibliografía (§15.2.3)
Almacenamiento de datos XML personalizado (§15.2.4)
Maestro de notas (§13.3.4)
Invalidación del tema (§14.2.8)
Miniatura (§15.2.16)

Una parte de diapositiva de notas puede contener relaciones explícitas con las siguientes partes definidas por ISO/IEC 29500:

Audio (§15.2.2)
Gráfico (§14.2.1)
Parte de contenido (§15.2.4)
Diagramas: Colores del diagrama (§14.2.3), Datos de diagrama (§14.2.4), Definición de diseño de diagrama (§14.2.5) y Estilos de diagrama (§14.2.6)
Persistencia del control incrustado (§15.2.9)
Objeto incrustado (§15.2.10)
Paquete incrustado (§15.2.11)
Hipervínculo (§15.3)
Imagen (§15.2.14)
Vídeo (§15.2.15)

La parte de diapositiva de notas no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de patrón de documentos

El elemento raíz de la parte maestro de documentos es el <elemento handoutMaster> .

La especificación ISO/IEC 29500 describe la parte de patrón de documentos de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene la apariencia, la posición y el tamaño del texto, la fecha o el número de página de las diapositivas, notas, encabezado y pie de página del documento de la presentación.

Un paquete debe incluir como máximo una parte de patrón de documentos, que debe ser el destino de una relación explícita a partir de la parte de presentación (§13.3.6).

Ejemplo: El siguiente elemento de relación de elementos de presentación contiene una relación con la parte del patrón de entrega, que se almacena en el elemento ZIP handoutMasters/handoutMaster1.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId5"  
        Type="https://…/handoutMaster"  
        Target="handoutMasters/handoutMaster1.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser handoutMaster. Ejemplo:

<p:handoutMaster xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld\>  
    <p:clrMap … >  
</p:handoutMaster>

Una parte de patrón de documentos debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de patrón de documentos puede contener relaciones implícitas con las siguientes partes definidas por ISO/IEC 29500:

Características adicionales (§15.2.1)
Bibliografía (§15.2.3)
Almacenamiento de datos XML personalizado (§15.2.4)
Tema (§14.2.7)
Miniatura (§15.2.16)

Una parte de patrón de documentos puede contener relaciones explícitas con las siguientes partes definidas por ISO/IEC 29500:

Audio (§15.2.2)
Gráfico (§14.2.1)
Parte de contenido (§15.2.4)
Diagramas: Colores del diagrama (§14.2.3), Datos de diagrama (§14.2.4), Definición de diseño de diagrama (§14.2.5) y Estilos de diagrama (§14.2.6)
Persistencia del control incrustado (§15.2.9)
Objeto incrustado (§15.2.10)
Paquete incrustado (§15.2.11)
Hipervínculo (§15.3)
Imagen (§15.2.14)
Vídeo (§15.2.15)

Una parte de patrón de documentos no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de comentarios

El elemento raíz de la parte Comments es el <elemento cmLst> .

La especificación ISO/IEC 29500 describe la parte de comentarios de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene los comentarios de una sola diapositiva. Cada comentario está vinculado a su autor mediante un identificador de autor. La combinación de identificador de autor y número de índice de cada comentario es única.

Un paquete debe incluir una parte de comentarios para cada diapositiva que contenga uno o varios comentarios, y cada uno de esas partes debe ser el destino de una relación implícita a partir de su parte de diapositiva correspondiente (§13.3.8).

Ejemplo: El siguiente elemento slide part-relationship contiene una relación con un elemento Comments, que se almacena en el elemento ZIP .. /comments/comment2.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId4"  
        Type="https://…/comments"  
        Target="../comments/comment2.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser cmLst.

Ejemplo: la parte Comentarios contiene tres comentarios, dos creados por un autor y uno creado por otro, todo en las fechas y horas que se muestran. Los números de índice se asignan por autor, comenzando por 1 para el primer comentario de un autor:

<p:cmLst xmlns:p="…" …>  
    <p:cm authorId="0" dt="2005-11-13T17:00:22.071" idx="1">  
        <p:pos x="4486" y="1342"/>  
        <p:text>Comment text goes here.</p:text>  
    </p:cm>  
    <p:cm authorId="0" dt="2005-11-13T17:00:34.849" idx="2">  
        <p:pos x="3607" y="1867"/>  
        <p:text>Another comment's text goes here.</p:text>  
    </p:cm>  
    <p:cm authorId="1" dt="2005-11-15T00:06:46.919" idx="1">  
        <p:pos x="1493" y="2927"/>  
        <p:text>comment …</p:text>  
    </p:cm>  
</p:cmLst>

Una parte de comentarios debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de comentarios no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Parte de autor de comentarios

El elemento raíz de la parte Comments Author es el <elemento cmAuthorLst> .

La especificación ISO/IEC 29500 describe la parte de autor de comentarios de PresentationML de Office Open XML de la siguiente manera:

Una instancia de este tipo de parte contiene información acerca de cada autor que agregó un comentario al documento. Esta información incluye el nombre del autor, sus iniciales, un identificador de autor único, un recuento del último índice de comentarios usado y un color para mostrar. (El color puede usarse al mostrar los comentarios para distinguir comentarios de autores diferentes).

Un paquete debe incluir como máximo una parte de autores de comentarios. Si existe, esa parte debe ser el destino de una relación implícita a partir de la parte de presentación (§13.3.6).

Ejemplo: El siguiente elemento de relación de elemento de presentación contiene una relación con la parte Autores de comentarios, que se almacena en el elemento ZIP commentAuthors.xml:

<Relationships xmlns="…">  
    <Relationship Id="rId8"  
        Type="https://…/commentAuthors" Target="commentAuthors.xml"/>  
</Relationships>

El elemento raíz de una parte de este tipo de contenido debe ser cmAuthorLst.

Ejemplo: Dos personas han creado comentarios en este documento: Mary Smith y Peter Jones. Las iniciales de ella son "cec", su identificador de autor es 0 y el índice de colores para mostrar de sus comentarios es 0. Dado que el valor del último índice de comentarios usado de Cecilia es 3, el siguiente índice de comentarios que se usará para ella será 4. Las iniciales de él son "ton", su identificador de autor es 1 y el índice de colores para mostrar de sus comentarios es 1. Dado que el valor del último índice de comentarios usado de Tomás es 1, el siguiente índice de comentarios que se usará para él será 2:

<p:cmAuthorLst xmlns:p="…" …>  
    <p:cmAuthor id="0" name="Mary Smith" initials="mas" lastIdx="3"
clrIdx="0"/>  
    <p:cmAuthor id="1" name="Peter Jones" initials="pjj" lastIdx="1"
clrIdx="1"/>  
</p:cmAuthorLst>

Una parte de autores de comentarios debe encontrarse dentro del paquete que contiene la parte de relaciones (expresado sintácticamente, el atributo TargetMode del elemento Relationship debe ser Internal).

Una parte de autores de comentarios no debe tener relaciones implícitas o explícitas con ninguna otra parte definida por ISO/IEC 29500.

Estructura de un archivo de presentación mínimo

Ahora que se ha familiarizado con las partes de un documento PresentationML, considere el modo en que estas partes se implementan y conectan en un archivo de presentación real. Como se muestra en el artículo How to: Create a presentation document by providing a file name ,you can use the Open XML API to build up a minimum presentation file, part by part.

Un archivo de presentación mínimo está formado por una parte de presentación, representado por el archivo presentation.xml, así como por una parte de propiedades de presentación (presProps.xml), una parte de patrón de diapositivas (slideMaster.xml), una parte de diseño de diapositiva (slideLayout.xml) y una parte de tema (theme.xml). Una o varias partes de diapositiva (slide.xml) son opcionales.

La estructura de empaquetado de un documento de presentación contiene varias referencias entre las partes, incluidas algunas referencias circulares. Por ejemplo, los diseños de diapositiva hacen referencia a patrones de diapositivas y los patrones de diapositivas hacen referencia a diseños de diapositiva.

Código XML de PresentationML generado

Después de ejecutar el código del SDK de Open XML para generar una presentación, puede explorar el contenido del paquete .zip para ver el código XML presentationML. Para ver el paquete .zip, cambie el nombre de la extensión en la presentación mínima de .pptx a .zip. Dentro del paquete .zip, hay varias partes que componen la presentación mínima.

En la figura 1 se muestra la estructura de la carpeta ppt del paquete .zip de una presentación mínima que contiene una sola diapositiva.

Figura 1. Estructura de una carpeta de presentación mínima

Estructura de una carpeta de presentación mínima

El archivo presentation.xml contiene <elementos sld> (Slide) que hacen referencia a las diapositivas de la presentación. Cada diapositiva se asocia a la presentación por medio de un identificador de diapositiva y un identificador de relación. slideID es el identificador que se usa dentro de un paquete para identificar una diapositiva y debe ser único dentro de la presentación. El atributo id es el identificador de relación que identifica la definición de parte de diapositiva asociada a una diapositiva. Para obtener más información sobre la parte de la diapositiva, vea Trabajar con diapositivas de presentación.

El siguiente código XML es el PresentationML que representa la parte de presentación de un documento de presentación que contiene una sola diapositiva. Este código se genera al ejecutar el código del SDK de Open XML para crear una presentación mínima.

    <?xml version="1.0" encoding="utf-8"?>
    <p:presentation xmlns:p="https://schemas.openxmlformats.org/presentationml/2006/main">
      <p:sldMasterIdLst>
        <p:sldMasterId id="2147483648"
                       r:id="rId1"
                       xmlns:r="https://schemas.openxmlformats.org/officeDocument/2006/relationships" />
      </p:sldMasterIdLst>
      <p:sldIdLst>
        <p:sldId id="256"
                 r:id="rId2"
                 xmlns:r="https://schemas.openxmlformats.org/officeDocument/2006/relationships" />
      </p:sldIdLst>
      <p:sldSz cx="9144000"
               cy="6858000"
               type="screen4x3" />
      <p:notesSz cx="6858000"
                 cy="9144000" />
      <p:defaultTextStyle />
    </p:presentation>

El siguiente código XML es el PresentationML que representa la parte de relación del documento de presentación. Este código se genera al ejecutar el SDK de Open XML para crear una presentación mínima.

    <?xml version="1.0" encoding="utf-8"?>
    <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
      <Relationship Type="https://schemas.openxmlformats.org/officeDocument/2006/relationships/slide"
                    Target="/ppt/slides/slide.xml"
                    Id="rId2" />
      <Relationship Type="https://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster"
                    Target="/ppt/slideLayouts/slideMasters/slideMaster.xml"
                    Id="rId1" />
      <Relationship Type="https://schemas.openxmlformats.org/officeDocument/2006/relationships/theme"
                    Target="/ppt/slideLayouts/slideMasters/theme/theme.xml"
                    Id="rId5" />
    </Relationships>

El siguiente código XML es el PresentationML que representa la parte de diapositiva del documento de presentación. Cada diapositiva de una presentación tiene una parte de diapositiva asociado. Este código se genera al ejecutar el SDK de Open XML para crear una presentación mínima.

    <?xml version="1.0" encoding="utf-8"?>
    <p:sld xmlns:p="https://schemas.openxmlformats.org/presentationml/2006/main">
      <p:cSld>
        <p:spTree>
          <p:nvGrpSpPr>
            <p:cNvPr id="1"
                     name="" />
            <p:cNvGrpSpPr />
            <p:nvPr />
          </p:nvGrpSpPr>
          <p:grpSpPr>
            <a:xfrm xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
          </p:grpSpPr>
          <p:sp>
            <p:nvSpPr>
              <p:cNvPr id="2"
                       name="Title 1" />
              <p:cNvSpPr>
                <a:spLocks noGrp="1"
                           xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
              </p:cNvSpPr>
              <p:nvPr>
                <p:ph />
              </p:nvPr>
            </p:nvSpPr>
            <p:spPr />
            <p:txBody>
              <a:bodyPr xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
              <a:lstStyle xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
              <a:p xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main">
                <a:endParaRPr lang="en-US" />
              </a:p>
            </p:txBody>
          </p:sp>
        </p:spTree>
      </p:cSld>
      <p:clrMapOvr>
        <a:masterClrMapping xmlns:a="https://schemas.openxmlformats.org/drawingml/2006/main" />
      </p:clrMapOvr>
    </p:sld>

Escenario de presentación típica

Una presentación típica no tiene una configuración mínima. Puede incluir varias diapositivas, cada una de las cuales hace referencia a diseños de diapositiva y patrones de diapositivas, y puede incluir comentarios. Además, una presentación puede incluir diapositivas de documento y de notas, cada una de las cuales se representa con partes independientes. Estas partes adicionales se incluyen en el paquete .zip del documento de presentación.

En la figura 2 se muestra la mayoría de los elementos que pueden encontrarse en una presentación típica.

Figura 2. Elementos de un archivo PresentationML

Elementos de un archivo PresentationML

Vea también

Cómo: Crear un documento de presentación proporcionando un nombre de archivo Working with presentations Working with presentation slides Working with slide masters Working with slide layouts

Share via