ShapeGuide Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Guia da Forma.
Esta classe está disponível no Office 2007 e superior.
Quando o objeto é serializado como xml, o nome qualificado é a:gd.
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(10, "gd")]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElementpublic class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr(10, "gd")]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("a:gd")]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("a:gd")]
public class ShapeGuide : DocumentFormat.OpenXml.TypedOpenXmlLeafElement[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(10, "gd")>]
type ShapeGuide = class
inherit OpenXmlLeafElementtype ShapeGuide = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr(10, "gd")>]
type ShapeGuide = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("a:gd")>]
type ShapeGuide = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("a:gd")>]
type ShapeGuide = class
inherit TypedOpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type ShapeGuide = class
inherit OpenXmlLeafElementPublic Class ShapeGuide
Inherits OpenXmlLeafElementPublic Class ShapeGuide
Inherits TypedOpenXmlLeafElement- Herança
- Herança
- Atributos
Comentários
[ISO/IEC 29500-1 1st Edition]
gd (Shape Guide)
Este elemento especifica o precense de um guia de forma que é utilizado para governar a geometria da forma especificada. Um guia de forma consiste numa fórmula e num 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 este elemento.
[Nota: a ordem pela qual os guias são especificados determina a ordem pela qual os respetivos valores são calculados. Por exemplo, não é possível especificar um guia que utilize outro resultado de guias quando esse guia ainda não foi calculado. nota de fim]
[Exemplo: considere o caso em que o utilizador gostaria de especificar um triângulo com o limite inferior definido não por pontos estáticos, mas por utilizar um parâmetro variável, nomeadamente um guia. Considere os diagramas e DrawingML mostrados abaixo. Este primeiro triângulo foi desenhado com uma margem inferior igual a 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 da 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>
No entanto, se alterarmos o guia para metade, ou seja, 1/3. Em seguida, vemos que toda a margem inferior do triângulo se move até agora ocupar apenas 1/3 do espaço do toal dentro da caixa delimitadora da forma. Isto deve-se ao facto de ambos os pontos inferiores neste triângulo dependerem deste guia para as suas posições coordenadas. O triângulo e o DrawingML correspondentes 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 da Forma) | Especifica a fórmula utilizada 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 executar nestes argumentos para gerar um valor para um guia. Existem um total de 17 fórmulas diferentes disponíveis. Estes são apresentados abaixo com a utilização de cada definido. ('*/') - Multiplicar Fórmula de Divisão Argumentos: 3 (fmla="*/ x y z") Utilização: "*/ x y z" = ((x * y) / z) = valor deste guia ('+-') - Adicionar Subtrair Fórmula Argumentos: 3 (fmla="+- x y z") Utilização: "+- x y z" = ((x + y) - z) = valor deste guia ('+/') - Adicionar Fórmula de Divisão Argumentos: 3 (fmla="+/ x y z") Utilização: "+/ x y z" = ((x + y) / z) = valor deste guia ('?:') - Fórmula If Else Argumentos: 3 (fmla="?: x y z") Utilização: "?: x y z" = se (x > 0), então y = valor deste guia, else z = valor deste guia ('abs') - Fórmula de Valor Absoluto Argumentos: 1 (fmla="abs x") Utilização: "abs x" = se (x < 0), então (-1) * x = valor deste guia else x = valor deste guia ('at2') - Fórmula ArcTan Argumentos: 2 (fmla="at2 x y") Utilização: "at2 x y" = arctan(y/ x) = valor deste guia ('cat2') - Fórmula Cosine ArcTan Argumentos: 3 (fmla="cat2 x y z") Utilização: "cat2 x y z" = (x*(cos(arctan(z / y))) = valor deste guia ('cos') - Fórmula Cosseno Argumentos: 2 (fmla="cos x y") Utilização: "cos x y" = (x * cos( y )) = valor deste guia ('max') - Fórmula de Valor Máximo Argumentos: 2 (fmla="máx. x y") Utilização: "máx. x y" = se (x > y), então x = valor deste guia else y = valor deste guia ('min') - Fórmula de Valor Mínimo Argumentos: 2 (fmla="min x y") Utilização: "min x y" = se (x < y), então x = valor deste guia else y = valor deste guia ('mod') - Fórmula Modulo Argumentos: 3 (fmla="mod x y z") Utilização: "mod x y z" = sqrt(x^2 + b^2 + c^2) = valor deste guia ('pin') - Afixar à Fórmula Argumentos: 3 (fmla="pin x y z") Utilização: "pin x y z" = se (y < x), então x = valor deste guia senão se (y > z), então z = valor deste guia else y = valor deste guia ('sat2') - Fórmula Sine ArcTan Argumentos: 3 (fmla="sat2 x y z") Utilização: "sat2 x y z" = (x*sin(arctan(z / y))) = valor deste guia ('sin') - Fórmula Seno Argumentos: 2 (fmla="sin x y") Utilização: "sin x y" = (x * sin( y )) = valor deste guia ('sqrt') - Fórmula de Raiz Quadrada Argumentos: 1 (fmla="sqrt x") Utilização: "sqrt x" = sqrt(x) = valor deste guia ('tan') - Fórmula tangente Argumentos: 2 (fmla="tan x y") Utilização: "tan x y" = (x * tan( y )) = valor deste guia ('val') - Fórmula de Valor Literal Argumentos: 1 (fmla="val x") Utilização: "val x" = x = valor deste guia [Nota: os guias que tenham uma fórmula de valor literal especificada através de fmla="val x" acima só devem ser utilizadas no avLst como um valor de ajuste para a forma. No entanto, isto não é estritamente aplicado. nota de fim] Os valores possíveis para este atributo são definidos pelo ST_GeomGuideFormula tipo simples (}20.1.10.27). |
| name (Nome do Guia da Forma) | Especifica o nome que é utilizado para fazer referência a este guia. Este nome pode ser utilizado tal como uma variável dentro de uma equação. Ou seja, este nome pode ser substituído por valores literais noutros guias ou pela especificação do caminho da forma. Os valores possíveis para este atributo são definidos pelo ST_GeomGuideName tipo simples (}20.1.10.28). |
[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_GeomGuide) está localizada em {A.4.1. nota de fim]
ISO/IEC29500: 2008.
Construtores
| Nome | Description |
|---|---|
| ShapeGuide() |
Inicializa uma nova instância da classe ShapeGuide. |
Propriedades
| Nome | Description |
|---|---|
| ChildElements |
Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement) |
| ExtendedAttributes |
Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement) |
| Features |
Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement) |
| FirstChild |
Obtém o primeiro elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| Formula |
Fórmula do Guia da 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 subordinados. (Herdado de OpenXmlLeafElement) |
| InnerText |
Obtém ou define os valores concatenados do nó e de todos os respetivos subordinados. (Herdado de OpenXmlElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas elementos subordinados do elemento atual. (Herdado de OpenXmlLeafElement) |
| LastChild |
Obtém o último elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| LocalName |
Guia da Forma. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é a:gd. |
| LocalName |
Obtém o nome local do elemento atual. (Herdado de OpenXmlElement) |
| MCAttributes |
Obtém ou define os atributos de compatibilidade de markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement) |
| Name |
Nome do Guia da Forma Representa o seguinte atributo no esquema: nome |
| NamespaceDeclarations |
Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement) |
| NamespaceUri |
Obtém o URI do espaço de nomes 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 respetivos elementos subordinados. (Herdado de OpenXmlElement) |
| Parent |
Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement) |
| Prefix |
Obtém o prefixo de espaço de nomes 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
| Nome | Description |
|---|---|
| AddAnnotation(Object) |
Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| AddNamespaceDeclaration(String, String) |
Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement) |
| Ancestors() |
Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement) |
| Ancestors<T>() |
Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| Annotation(Type) |
Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| Annotation<T>() |
Obtenha o primeiro objeto de anotação do tipo especificado a partir 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 fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| Append(OpenXmlElement[]) |
Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| AppendChild<T>(T) |
Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlElement) |
| ClearAllAttributes() |
Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement) |
| Clone() |
Cria um duplicado do nó atual. (Herdado de OpenXmlElement) |
| CloneNode(Boolean) |
Cria um duplicado deste nó. |
| Descendants() |
Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement) |
| Descendants<T>() |
Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement) |
| Elements() |
Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| Elements<T>() |
Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| ElementsAfter() |
Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement) |
| ElementsBefore() |
Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement) |
| GetAttribute(String, String) |
Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement) |
| GetAttributes() |
Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement) |
| GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement) |
| GetFirstChild<T>() |
Localiza o primeiro elemento subordinado 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 subordinados 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 aparece depois de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement) |
| IsBefore(OpenXmlElement) |
Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement) |
| LookupNamespace(String) |
Resolve o prefixo do espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement) |
| LookupPrefix(String) |
Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement) |
| NextSibling() |
Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement) |
| NextSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement) |
| PrependChild<T>(T) |
Insere o elemento especificado no início da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| PreviousSibling() |
Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| PreviousSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| Remove() |
Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement) |
| RemoveAllChildren() |
Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlLeafElement) |
| RemoveAllChildren<T>() |
Remova todos os elementos subordinados 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 subordinado especificado da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| RemoveNamespaceDeclaration(String) |
Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
Substitui um elemento subordinado por outro elemento subordinado na lista de elementos subordinados 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 é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement) |
| WriteTo(XmlWriter) |
Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IEnumerable.GetEnumerator() |
Guia da Forma. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é a:gd. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement) |