ShapeGuide Classe

Definição

Namespace:

DocumentFormat.OpenXml.Drawing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Guia de Formas.

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

Quando o objeto é serializado como xml, seu nome qualificado é a:gd.

public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement

type ShapeGuide = class
    inherit OpenXmlLeafElement

Public Class ShapeGuide
Inherits OpenXmlLeafElement

Herança

Object

OpenXmlElement

OpenXmlLeafElement

ShapeGuide

Comentários

[ISO/IEC 29500-1 1st Edition]

gd (Shape Guide)

Esse elemento especifica o precense de um guia de forma que é usado para controlar a geometria da forma especificada. Um guia de forma consiste em uma fórmula e um nome ao qual o resultado da fórmula é atribuído. As fórmulas reconhecidas são listadas com a documentação do atributo fmla para esse elemento.

[Observação: a ordem na qual os guias são especificados determina a ordem na qual seus valores são calculados. Por exemplo, não é possível especificar um guia que usa outro resultado de guias quando esse guia ainda não foi calculado. nota final]

[Exemplo: considere o caso em que o usuário gostaria de especificar um triângulo com sua borda inferior definida não por pontos estáticos, mas usando um parâmetro variável, ou seja, um guia. Considere os diagramas e DrawingML mostrados abaixo. Este primeiro triângulo foi desenhado com uma borda inferior que é igual ao 2/3 do valor da altura da forma. Assim, vemos na figura abaixo que o triângulo parece ocupar 2/3 do espaço vertical dentro da caixa delimitadora de forma.

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>  

Se, no entanto, alterarmos o guia para metade disso, ou seja, 1/3. Em seguida, vemos toda a borda inferior do triângulo mover para agora apenas ocupar 1/3 do espaço de dedo do dedo dentro da caixa delimitadora de forma. Isso ocorre porque ambos os pontos inferiores neste triângulo dependem deste guia para suas posições de coordenadas. O triângulo e o DrawingML correspondente mostrados abaixo ilustram este ponto.

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

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

exemplo final]

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

Atributos	Descrição
fmla (Fórmula do Guia de Forma)	Especifica a fórmula usada para calcular o valor de um guia. Cada fórmula tem um determinado número de argumentos e um conjunto específico de operações a serem executadas nesses argumentos para gerar um valor para um guia. Há um total de 17 fórmulas diferentes disponíveis. Estes são mostrados abaixo com o uso de cada definido. ('*/') – Multiplicar fórmula de divisão Argumentos: 3 (fmla="*/ x y z") Uso: "*/ x y z" = ((x * y) / z) = valor deste guia ('+-') – Adicionar fórmula de subtração Argumentos: 3 (fmla="+- x y z") Uso: "+- x y z" = ((x + y) - z) = valor deste guia ('+/') – Adicionar Fórmula divide Argumentos: 3 (fmla="+/ x y z") Uso: "+/ x y z" = ((x + y) / z) = valor deste guia ('?:') - Se outra fórmula Argumentos: 3 (fmla="?: x y z") Uso: "?: x y z" = if (x > 0), then y = value of this guide, else z = valor deste guia ('abs') – Fórmula de valor absoluto Argumentos: 1 (fmla="abs x") Uso: "abs x" = if (x < 0), then (-1) * x = value of this guide else x = valor deste guia ('at2') – Fórmula ArcTan Argumentos: 2 (fmla="at2 x y") Uso: "at2 x y" = arctan(y/x) = valor deste guia ('cat2') – Fórmula Cosine ArcTan Argumentos: 3 (fmla="cat2 x y z") Uso: "cat2 x y z" = (x*(cos(arctan(z /y))) = valor deste guia ('cos') – Fórmula cosina Argumentos: 2 (fmla="cos x y") Uso: "cos x y" = (x * cos( y )) = valor deste guia ('max') – Fórmula de valor máximo Argumentos: 2 (fmla="max x y") Uso: "max x y" = if (x > y), em seguida, x = valor deste guia else y = valor deste guia ('min') – Fórmula de valor mínimo Argumentos: 2 (fmla="min x y") Uso: "min x y" = se (x < y), x = valor deste guia else y = valor deste guia ('mod') – Fórmula modulo Argumentos: 3 (fmla="mod x y z") Uso: "mod x y z" = sqrt(x^2 + b^2 + c^2) = valor deste guia ('pin') – Fixar na fórmula Argumentos: 3 (fmla="pin x y z") Uso: "pin x y z" = if (y < x), then x = value of this guide caso contrário, se (y > z), z = valor deste guia else y = valor deste guia ('sat2') – Fórmula Sine ArcTan Argumentos: 3 (fmla="sat2 x y z") Uso: "sat2 x y z" = (x*sin(arctan(z /y)) = valor deste guia ('sin') – Fórmula Sine Argumentos: 2 (fmla="sin x y") Uso: "sin x y" = (x * sin( y )) = valor deste guia ('sqrt') – Fórmula raiz quadrada Argumentos: 1 (fmla="sqrt x") Uso: "sqrt x" = sqrt(x) = valor deste guia ('tan') – Fórmula tangente Argumentos: 2 (fmla="tan x y") Uso: "tan x y" = (x * tan( y )) = valor deste guia ('val') – Fórmula de valor literal Argumentos: 1 (fmla="val x") Uso: "val x" = x = valor deste guia [Observação: guias que têm uma fórmula de valor literal especificada via fmla="val x" acima só devem ser usados no avLst como um valor de ajuste para a forma. Isso, no entanto, não é estritamente imposto. nota final] Os valores possíveis para esse atributo são definidos pelo tipo ST_GeomGuideFormula simples (§20.1.10.27).
nome (Nome do guia de forma)	Especifica o nome usado para fazer referência a este guia. Esse nome pode ser usado exatamente como uma variável faria dentro de uma equação. Esse nome pode ser substituído por valores literais em outros guias ou na especificação do caminho da forma. Os valores possíveis para esse atributo são definidos pelo tipo ST_GeomGuideName simples (§20.1.10.28).

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

ISO/IEC29500: 2008.

Construtores

ShapeGuide()

Inicializa uma nova instância da classe ShapeGuide.

Propriedades

ChildElements	Obtém todos os nós filho do elemento atual. (Herdado de OpenXmlElement)
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. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
Formula	Fórmula do Guia de Forma Representa o seguinte atributo no esquema: fmla
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 OpenXmlLeafElement)
InnerText	Obtém ou define os valores concatenados do nó e de todos os seus filhos. (Herdado de OpenXmlElement)
InnerXml	Obtém ou define a marcação que representa apenas elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
LastChild	Obtém o último filho do elemento OpenXmlElement. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de marcação. Retorna nulo se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement)
Name	Nome do guia de forma Representa o seguinte atributo no esquema: nome
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)
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)
Prefix	Obtém o prefixo namespace do elemento atual. (Herdado de OpenXmlElement)
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos 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 OpenXmlElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement)
Clone()	Cria uma duplicata do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria uma duplicata desse nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	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 OpenXmlElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual é 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 elementos filho do elemento atual. (Herdado de OpenXmlElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual de seu pai. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Remova todos os elementos filho do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento filho especificado da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de namespace do prefixo especificado. Não removerá nada se não houver nenhum prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um elemento filho por outro elemento filho na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for 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()	Guia de Formas. Essa classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é a:gd. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)