ShapeGuide Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Drawing

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Guía de formas.

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

Cuando el objeto se serializa como xml, su nombre completo es un: gd.

public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement

type ShapeGuide = class
    inherit OpenXmlLeafElement

Public Class ShapeGuide
Inherits OpenXmlLeafElement

Herencia

Object

OpenXmlElement

OpenXmlLeafElement

ShapeGuide

Comentarios

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

gd (Shape Guide)

Este elemento especifica el precense de una guía de formas que se usa para controlar la geometría de la forma especificada. Una guía de formas consta de una fórmula y un nombre al que se asigna el resultado de la fórmula. Las fórmulas reconocidas se enumeran con la documentación del atributo fmla para este elemento.

[Nota: El orden en que se especifican las guías determina el orden en que se calculan sus valores. Por ejemplo, no es posible especificar una guía que use otro resultado de guías cuando esa guía aún no se haya calculado. Fin de la nota]

[Ejemplo: considere el caso en el que el usuario desea especificar un triángulo con su borde inferior definido no por puntos estáticos, sino mediante un parámetro variable, es decir, una guía. Tenga en cuenta los diagramas y DrawingML que se muestran a continuación. Este primer triángulo se ha dibujado con un borde inferior que es igual a 2/3 el valor del alto de la forma. Por lo tanto, vemos en la ilustración siguiente que el triángulo parece ocupar 2/3 del espacio vertical dentro del cuadro delimitador de formas.

578c5088-5a52-4f13-a3f4-8a0fb4c8ed2f

<a:xfrm>  
  <a:off x="3200400" y="1600200"/>  
  <a:ext cx="1705233" cy="679622"/>  
</a:xfrm>  
<a:custGeom>  
  <a:avLst/>   
  <a:gdLst>  
    <a:gd name="myGuide" fmla="*/ h 2 3"/>  
  </a:gdLst>  
  <a:ahLst/>  
  <a:cxnLst/>  
  <a:rect l="0" t="0" r="0" b="0"/>  
  <a:pathLst>  
    <a:path w="1705233" h="679622">  
      <a:moveTo>  
        <a:pt x="0" y="myGuide"/>  
      </a:moveTo>  
      <a:lnTo>  
        <a:pt x="1705233" y="myGuide"/>  
      </a:lnTo>  
      <a:lnTo>  
        <a:pt x="852616" y="0"/>  
      </a:lnTo>  
      <a:close/>  
    </a:path>  
  </a:pathLst>  
</a:custGeom>  

Sin embargo, si cambiamos la guía a la mitad, es decir, 1/3. A continuación, vemos que todo el borde inferior del triángulo se mueve a ahora solo ocupa 1/3 del espacio toal dentro del cuadro delimitador de formas. Esto se debe a que ambos puntos inferiores de este triángulo dependen de esta guía para sus posiciones de coordenadas. El triángulo y el drawingML correspondiente que se muestran a continuación ilustran este punto.

98bdf8a6-a22a-4467-9f2f-737dd98edbe1

<a:gdLst>  
  <a:gd name="myGuide" fmla="*/ h 1 3"/>  
</a:gdLst>  

Fin del ejemplo]

Elementos primarios
avLst (§20.1.9.5); gdLst (§20.1.9.12)

Atributos	Descripción
fmla (fórmula de guía de formas)	Especifica la fórmula que se usa para calcular el valor de una guía. Cada fórmula tiene un número determinado de argumentos y un conjunto específico de operaciones para realizar en estos argumentos con el fin de generar un valor para una guía. Hay un total de 17 fórmulas diferentes disponibles. A continuación se muestran con el uso de cada definido. ('*/') - Multiplicar fórmula de división Argumentos: 3 (fmla="*/ x y z") Uso: "*/ x y z" = ((x * y) / z) = valor de esta guía ('+-') - Agregar fórmula de resta Argumentos: 3 (fmla="+- x y z") Uso: "+- x y z" = ((x + y) - z) = valor de esta guía ('+/') - Agregar fórmula de división Argumentos: 3 (fmla="+/ x y z") Uso: "+/ x y z" = ((x + y) / z) = valor de esta guía ('?:') - If Else Formula Argumentos: 3 (fmla="?: x y z") Uso: "?: x y z" = if (x > 0), y = value de esta guía, else z = valor de esta guía ('abs') - Fórmula de valor absoluto Argumentos: 1 (fmla="abs x") Uso: "abs x" = if (x < 0) y, a continuación, (-1) * x = valor de esta guía else x = valor de esta guía ('at2') - ArcTan Formula Argumentos: 2 (fmla="at2 x y") Uso: "at2 x y" = arctan(y / x) = valor de esta guía ('cat2') - Cosine ArcTan Formula Argumentos: 3 (fmla="cat2 x y z") Uso: "cat2 x y z" = (x*(cos(arctan(z / y))) = valor de esta guía ('cos') - Coseno Formula Argumentos: 2 (fmla="cos x y") Uso: "cos x y" = (x * cos( y )) = valor de esta guía ('max'): fórmula de valor máximo Argumentos: 2 (fmla="max x y") Uso: "max x y" = if (x > y), a continuación, x = valor de esta guía else y = valor de esta guía ('min') - Fórmula de valor mínimo Argumentos: 2 (fmla="min x y") Uso: "min x y" = if (x < y), luego x = valor de esta guía else y = valor de esta guía ('mod') - Fórmula de módulo Argumentos: 3 (fmla="mod x y z") Uso: "mod x y z" = sqrt(x^2 + b^2 + c^2) = valor de esta guía ('anclar') - Anclar a la fórmula Argumentos: 3 (fmla="pin x y z") Uso: "pin x y z" = if (y < x), a continuación, x = valor de esta guía else if (y > z), a continuación, z = valor de esta guía else y = valor de esta guía ('sat2') - Sine ArcTan Formula Argumentos: 3 (fmla="sat2 x y z") Uso: "sat2 x y z" = (x*sin(arctan(z / y))) = valor de esta guía ('sin') - Sine Formula Argumentos: 2 (fmla="sin x y") Uso: "sin x y" = (x * sin( y )) = valor de esta guía ('sqrt') - Fórmula raíz cuadrada Argumentos: 1 (fmla="sqrt x") Uso: "sqrt x" = sqrt(x) = valor de esta guía ('tan') - Fórmula tangente Argumentos: 2 (fmla="tan x y") Uso: "tan x y" = (x * tan( y )) = valor de esta guía ('val') - Fórmula de valor literal Argumentos: 1 (fmla="val x") Uso: "val x" = x = valor de esta guía [Nota: Las guías que tienen una fórmula de valor literal especificada a través de fmla="val x" anterior solo deben usarse dentro de avLst como un valor de ajuste para la forma. Sin embargo, esto no se aplica estrictamente. Fin de la nota] Los valores posibles para este atributo se definen mediante el ST_GeomGuideFormula tipo simple (§20.1.10.27).
name (Nombre de la guía de formas)	Especifica el nombre que se usa para hacer referencia a esta guía. Este nombre se puede usar igual que una variable dentro de una ecuación. Es decir, este nombre se puede sustituir por valores literales dentro de otras guías o la especificación de la ruta de acceso de la forma. Los valores posibles para este atributo se definen mediante el ST_GeomGuideName tipo simple (§20.1.10.28).

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

ISO/IEC29500: 2008.

Constructores

ShapeGuide()

Inicializa una nueva instancia de la clase ShapeGuide.

Propiedades

ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
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. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
Formula	Fórmula de guía de formas Representa el atributo siguiente en el esquema: fmla
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 OpenXmlLeafElement)
InnerText	Obtiene o establece los valores concatenados del nodo y todos sus elementos secundarios. (Heredado de OpenXmlElement)
InnerXml	Obtiene o establece el marcado que solo representa elementos secundarios del elemento actual. (Heredado de OpenXmlLeafElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
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)
Name	Nombre de la guía de formas Representa el atributo siguiente en el esquema: name
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)
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)
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
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)
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 OpenXmlElement)
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 OpenXmlElement)
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 en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlElement)
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 elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
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 OpenXmlLeafElement)
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 de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
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 un elemento secundario por otro elemento secundario en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
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()	Guía de formas. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es un: gd. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)