ShapeGuide クラス

定義

名前空間:

DocumentFormat.OpenXml.Drawing

アセンブリ:

DocumentFormat.OpenXml.dll

パッケージ:

DocumentFormat.OpenXml v3.0.1

図形ガイド。

このクラスは、Office 2007 以降で使用できます。

オブジェクトを xml としてシリアル化されるときに、修飾名は a:gd です。

public class ShapeGuide : DocumentFormat.OpenXml.OpenXmlLeafElement

type ShapeGuide = class
    inherit OpenXmlLeafElement

Public Class ShapeGuide
Inherits OpenXmlLeafElement

継承

Object

OpenXmlElement

OpenXmlLeafElement

ShapeGuide

注釈

[ISO/IEC 29500-1 1st Edition]

gd (Shape Guide)

この要素は、指定した図形のジオメトリを管理するために使用される図形ガイドの前置きを指定します。 図形ガイドは、数式と、数式の結果が割り当てられる名前で構成されます。 認識された数式は、この要素の fmla 属性ドキュメントと共に一覧表示されます。

[注: ガイドを指定する順序によって、その値が計算される順序が決まります。 たとえば、そのガイドがまだ計算されていない場合に別のガイドの結果を使用するガイドを指定することはできません。 メモの終了]

[例: ユーザーが、静的なポイントではなく、さまざまなパラメーター (つまりガイド) を使用して定義された下端の三角形を指定する場合を考えてみましょう。 次に示す図と DrawingML について考えてみましょう。 この最初の三角形は、図形の高さの値の 2/3 と等しい下端で描画されています。 したがって、下の図では、三角形が図形の境界ボックス内の垂直空間の 2/3 を占めているように見えます。

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>  

ただし、ガイドを半分に変更する場合は、つまり 1/3 です。 次に、三角形の下端全体が、図形の境界ボックス内の緩間空間の 1/3 のみを占めるようになります。 これは、この三角形の下の点の両方が、座標位置に関するこのガイドに依存するためです。 次に示す三角形と対応する DrawingML がこの点を示しています。

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

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

例終わり]

親の要素
avLst (§20.1.9.5);gdLst (§20.1.9.12)

属性	説明
fmla (図形ガイド式)	ガイドの値の計算に使用する数式を指定します。 各数式には、特定の数の引数と、ガイドの値を生成するためにこれらの引数に対して実行する特定の操作セットがあります。 合計 17 種類の数式を使用できます。 以下に、定義されているそれぞれの使用方法を示します。 ('*/') - 乗算除算数式 引数: 3 (fmla="*/ x y z") 使用法: "*/ x y z" = ((x * y) / z) = このガイドの値 ('+-') - 減算数式の追加 引数: 3 (fmla="+- x y z") 使用法: "+- x y z" = ((x + y) - z) = このガイドの値 ('+/') - 除算数式の追加 引数: 3 (fmla="+/ x y z") 使用法: "+/ x y z" = ((x + y) / z) = このガイドの値 ('?:') - If Else 数式 引数: 3 (fmla="?: x y z") 使用法: "?: x y z" = if (x > 0)、y = このガイドの値、 else z = このガイドの値 ('abs') - 絶対値の数式 引数: 1 (fmla="abs x") 使用法: "abs x" = if (x < 0)、次に (-1) * x = このガイドの値 else x = このガイドの値 ('at2') - ArcTan 数式 引数: 2 (fmla="at2 x y") 使用法: "at2 x y" = arctan(y / x) = このガイドの値 ('cat2') - Cosine ArcTan 数式 引数: 3 (fmla="cat2 x y z") 使用法: "cat2 x y z" = (x*(cos(arctan(z/y))) = このガイドの値 ('cos') - コサイン式 引数: 2 (fmla="cos x y") 使用法: "cos x y" = (x * cos( y )) = このガイドの値 ('max') - 最大値の数式 引数: 2 (fmla="max x y") 使用法: "max x y" = if (x > y)、x = このガイドの値 else y = このガイドの値 ('min') - 最小値の数式 引数: 2 (fmla="min x y") 使用法: "min x y" = if (x < y)、x = このガイドの値 else y = このガイドの値 ('mod') - 剰余式 引数: 3 (fmla="mod x y z") 使用法: "mod x y z" = sqrt(x^2 + b^2 + c^2) = このガイドの値 ('pin') - 数式にピン留めする 引数: 3 (fmla="pin x y z") 使用法: "pin x y z" = if (y < x)、次に x = このガイドの値 else if (y > z)、z = このガイドの値 else y = このガイドの値 ('sat2') - 正弦 ArcTan 数式 引数: 3 (fmla="sat2 x y z") 使用法: "sat2 x y z" = (x*sin(arctan(z/y))) = このガイドの値 ('sin') - 正弦式 引数: 2 (fmla="sin x y") 使用法: "sin x y" = (x * sin( y )) = このガイドの値 ('sqrt') - 平方根数式 引数: 1 (fmla="sqrt x") 使用法: "sqrt x" = sqrt(x) = このガイドの値 ('tan') - タンジェント数式 引数: 2 (fmla="tan x y") 使用法: "tan x y" = (x * tan( y )) = このガイドの値 ('val') - リテラル値の数式 引数: 1 (fmla="val x") 使用法: "val x" = x = このガイドの値 [注: 上記の fmla="val x" で指定されたリテラル値の数式を持つガイドは、avLst 内でのみ図形の調整値として使用する必要があります。 ただし、これは厳密には適用されません。 メモの終了] この属性に使用できる値は、 ST_GeomGuideFormula 単純型 (§20.1.10.27) によって定義されます。
name (図形ガイド名)	このガイドを参照するために使用する名前を指定します。 この名前は、変数が数式内で使用するのと同じように使用できます。 つまり、この名前は、他のガイドまたは図形パスの指定内のリテラル値に置き換えることができます。 この属性に使用できる値は、 ST_GeomGuideName 単純型 (§20.1.10.28) によって定義されます。

[注: この要素のコンテンツ モデル (CT_GeomGuide) の W3C XML スキーマ定義は§A.4.1 にあります。 メモの終了]

ISO/IEC29500: 2008。

コンストラクター

ShapeGuide()

ShapeGuide クラスの新しいインスタンスを初期化します。

プロパティ

ChildElements	現在の要素のすべての子ノードを取得します。 (継承元 OpenXmlElement)
ExtendedAttributes	現在の要素のすべての拡張属性 (スキーマで定義されていない属性) を取得します。 (継承元 OpenXmlElement)
Features	現在の要素の を IFeatureCollection 取得します。 この機能コレクションは読み取り専用ですが、使用可能な場合は親パーツとパッケージから機能を継承します。 (継承元 OpenXmlElement)
FirstChild	OpenXmlElement 要素の最初の子を取得します。 このような OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
Formula	図形ガイドの数式 スキーマ内の次の属性を表します: fmla
HasAttributes	現在の要素に属性があるかどうかを示す値を取得します。 (継承元 OpenXmlElement)
HasChildren	現在の要素に子要素があるかどうかを示す値を取得します。 (継承元 OpenXmlLeafElement)
InnerText	ノードとそのすべての子の連結値を取得または設定します。 (継承元 OpenXmlElement)
InnerXml	現在の要素の子要素のみを表すマークアップを取得または設定します。 (継承元 OpenXmlLeafElement)
LastChild	OpenXmlElement 要素の最後の子を取得します。 このような OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
LocalName	現在の要素のローカル名を取得します。 (継承元 OpenXmlElement)
MCAttributes	マークアップ互換性属性を取得または設定します。 現在の要素に対してマークアップ互換性属性が定義されていない場合は null を返します。 (継承元 OpenXmlElement)
Name	図形ガイド名 スキーマ内の次の属性を表します。
NamespaceDeclarations	現在の要素で定義されているすべての名前空間宣言を取得します。 名前空間宣言がない場合は、空の列挙子を返します。 (継承元 OpenXmlElement)
NamespaceUri	現在の要素の名前空間 URI を取得します。 (継承元 OpenXmlElement)
OpenXmlElementContext	現在の要素の OpenXmlElementContext を取得します。 (継承元 OpenXmlElement)
OuterXml	現在の要素とそのすべての子要素を表すマークアップを取得します。 (継承元 OpenXmlElement)
Parent	現在の要素の親要素を取得します。 (継承元 OpenXmlElement)
Prefix	現在の要素の名前空間プレフィックスを取得します。 (継承元 OpenXmlElement)
XmlQualifiedName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)
XName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)

メソッド

AddAnnotation(Object)	現在の OpenXmlElement 要素の注釈の一覧にオブジェクトを追加します。 (継承元 OpenXmlElement)
AddNamespaceDeclaration(String, String)	現在のノードに名前空間宣言を追加します。 (継承元 OpenXmlElement)
Ancestors()	現在の要素のすべての先祖を列挙します。 (継承元 OpenXmlElement)
Ancestors<T>()	指定した型を持つ現在の要素の先祖のみを列挙します。 (継承元 OpenXmlElement)
Annotation(Type)	現在の OpenXmlElement 要素から、指定した型の最初の注釈オブジェクトを取得します。 (継承元 OpenXmlElement)
Annotation<T>()	現在の OpenXmlElement 要素から、指定した型の最初の注釈オブジェクトを取得します。 (継承元 OpenXmlElement)
Annotations(Type)	現在の OpenXmlElement 要素の指定した型を持つ注釈のコレクションを取得します。 (継承元 OpenXmlElement)
Annotations<T>()	現在の OpenXmlElement 要素の指定した型を持つ注釈のコレクションを取得します。 (継承元 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	要素のリストから現在の要素の子要素のリストの末尾に各要素を追加します。 (継承元 OpenXmlElement)
Append(OpenXmlElement[])	要素の配列から、現在の要素の子要素のリストの末尾に各要素を追加します。 (継承元 OpenXmlElement)
AppendChild<T>(T)	現在の要素の子ノードのリストの末尾に、指定した要素を追加します。 (継承元 OpenXmlElement)
ClearAllAttributes()	既知の属性と拡張属性の両方を含むすべての属性をクリアします。 (継承元 OpenXmlElement)
Clone()	現在のノードの複製を作成します。 (継承元 OpenXmlElement)
CloneNode(Boolean)	このノードの複製を作成します。
Descendants()	現在の要素のすべての子孫を列挙します。 (継承元 OpenXmlElement)
Descendants<T>()	T 型のすべての現在の要素の子孫を列挙します。 (継承元 OpenXmlElement)
Elements()	現在の要素のすべての子を列挙します。 (継承元 OpenXmlElement)
Elements<T>()	指定した型を持つ現在の要素の子のみを列挙します。 (継承元 OpenXmlElement)
ElementsAfter()	現在の要素に続き、現在の要素と同じ親を持つすべての兄弟要素を列挙します。 (継承元 OpenXmlElement)
ElementsBefore()	現在の要素の前にあり、現在の要素と同じ親を持つすべての兄弟要素を列挙します。 (継承元 OpenXmlElement)
GetAttribute(String, String)	指定したタグ名と名前空間 URI を持つ Open XML 属性を取得します。 (継承元 OpenXmlElement)
GetAttributes()	すべての属性のコピーを含むリストを取得します。 (継承元 OpenXmlElement)
GetEnumerator()	子コレクションを反復処理する列挙子を返します。 (継承元 OpenXmlElement)
GetFirstChild<T>()	T 型の最初の子要素を検索します。 (継承元 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	指定した参照要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertAfterSelf<T>(T)	現在の要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertAt<T>(T, Int32)	現在の要素の子要素のリスト内の指定したインデックスに、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	指定した参照要素の直前に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertBeforeSelf<T>(T)	現在の要素の直前に、指定した要素を挿入します。 (継承元 OpenXmlElement)
IsAfter(OpenXmlElement)	指定した要素の後に現在の要素がドキュメントの順序で表示されるかどうかを判断します。 (継承元 OpenXmlElement)
IsBefore(OpenXmlElement)	指定した要素の前に現在の要素がドキュメントの順序で表示されるかどうかを判断します。 (継承元 OpenXmlElement)
LookupNamespace(String)	現在のノードのコンテキストの名前空間プレフィックスを解決します。 (継承元 OpenXmlElement)
LookupPrefix(String)	現在の要素スコープ内の名前空間 URI の対応するプレフィックスを検索します。 (継承元 OpenXmlElement)
NextSibling()	現在の OpenXmlElement 要素の直後にある OpenXmlElement 要素を取得します。 次の OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
NextSibling<T>()	現在の OpenXmlElement 要素に続く指定した型を持つ OpenXmlElement 要素を取得します。 次の OpenXmlElement がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PrependChild<T>(T)	現在の要素の子要素のリストの先頭に、指定した要素を挿入します。 (継承元 OpenXmlElement)
PreviousSibling()	現在の OpenXmlElement 要素のすぐ前にある OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PreviousSibling<T>()	現在の OpenXmlElement の前に指定された型を持つ OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
Remove()	現在の要素を親から削除します。 (継承元 OpenXmlElement)
RemoveAllChildren()	現在の要素のすべての子要素を削除します。 (継承元 OpenXmlLeafElement)
RemoveAllChildren<T>()	T 型の現在の要素の子要素をすべて削除します。 (継承元 OpenXmlElement)
RemoveAnnotations(Type)	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAnnotations<T>()	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAttribute(String, String)	現在の要素から 属性を削除します。 (継承元 OpenXmlElement)
RemoveChild<T>(T)	現在の要素の子要素の一覧から、指定した子要素を削除します。 (継承元 OpenXmlElement)
RemoveNamespaceDeclaration(String)	指定したプレフィックスの名前空間宣言を削除します。 プレフィックスがない場合は、何も削除しません。 (継承元 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	子要素を、現在の要素の子要素のリスト内の別の子要素に置き換えます。 (継承元 OpenXmlElement)
SetAttribute(OpenXmlAttribute)	指定した要素に属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	要素に複数の属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
WriteTo(XmlWriter)	現在のノードを指定した XmlWriter に保存します。 (継承元 OpenXmlElement)

明示的なインターフェイスの実装

IEnumerable.GetEnumerator()	図形ガイド。 このクラスは、Office 2007 以降で使用できます。 オブジェクトを xml としてシリアル化されるときに、修飾名は a:gd です。 (継承元 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	子コレクションを反復処理する列挙子を返します。 (継承元 OpenXmlElement)