PresetTextWrap クラス

定義

名前空間:

DocumentFormat.OpenXml.Drawing

アセンブリ:

DocumentFormat.OpenXml.dll

パッケージ:

DocumentFormat.OpenXml v2.20.0

プリセットテキストワープ。

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

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

[DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")]
public class PresetTextWrap : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("a:prstTxWarp")>]
type PresetTextWrap = class
    inherit TypedOpenXmlCompositeElement

Public Class PresetTextWrap
Inherits TypedOpenXmlCompositeElement

継承

Object

OpenXmlElement

OpenXmlCompositeElement

TypedOpenXmlCompositeElement

PresetTextWrap

属性

SchemaAttrAttribute

注釈

[ISO/IEC 29500-1 1st Edition]

prstTxWarp (Preset Text Warp)

この要素は、テキストの変換に事前設定された幾何学的図形を使用するタイミングを指定します。 この操作は、正式にはテキスト ワープと呼ばれます。 生成するアプリケーションは、ST_TextShapeType リストに列挙されているすべてのプリセット ジオメトリをレンダリングできる必要があります。

[例: ユーザーが図形の歪みによってテキストの一部にアクセントを付けたい場合を考えてみましょう。 これを行うために、ST_TextShapeTypeリストからプリセット図形が選択され、テキストの本文全体に適用されます。

<p:sp>  
  <p:txBody>  
    <a:bodyPr wrap="none" rtlCol="0">  
      <a:prstTxWarp prst="textInflate">  
      </a:prstTxWarp>  
      <a:spAutoFit/>  
    </a:bodyPr>  
    <a:lstStyle/>  
    <a:p>  
…      <a:t>Sample Text</a:t>  
…    </a:p>  
  </p:txBody>  
</p:sp>  

8cf1df7f-8848-4e4c-a167-ed264eec5f58

結果として得られたテキストが、インフレ テキスト ワープが適用されたのを上に示します。 例終わり]

以下のST_TextShapeTypeリストの下に一覧表示されているプリセットのいずれかを使用すると、次の手順で DrawingML テキストの実行にテキスト ワープを適用できます。

ファイル形式のいずれかのテキスト ワープを見ると、それぞれが 2 つのパスで構成されていることがわかります。 これは、上位パス (最初に指定されたもの) と下部パス (2 番目に指定されたもの) に対応します。 次に、上のパスと下のパスは、テキストをワープする必要がある上線と基準線を表します。 これは次の方法で行われます。

固定されていないテキストが存在する四角形を計算します。 (テキストの周囲に可能な限りタイトな四角形、"空白文字" を除く空白なし)

元の文字を計算し、次の方法で終点と制御点を変更するために使用される 2 次および 3 次ベジエ曲線のそれぞれを取ります。..

元のテキストの四角形に沿って垂直線を水平方向に移動し、指定された終点またはコントロール ポイントが存在する水平方向のパーセンテージを見つけます。 (例: 中央の場合は.5)

次に、この点に対して垂直方向に同じことを行います。 このテキスト四角形の上部と下部がそれぞれの上と下の境界で、このポイントが存在する垂直方向のパーセンテージを見つけます。 (それぞれ 0.0 と 1.0)

ベジエ方程式の特定の点に対するパーセンテージが得られたので、歪んだテキスト環境の新しいポイントにマップできます。

ファイル形式で指定された上部と下部のパスに戻ると、これらを取得し、直線の円弧にフラット化できます (上と下の長さが異なる場合があります)

直線状にした後、両方を水平方向に測定して、元のテキスト四角形内で見つかったのと同じパーセンテージのポイントを見つけることができます。 (0.5 としましょう)

そのため、上のパスに沿って 50%、下のパスに沿って 50% を測定し、パスを元の曲線の形に戻します。

これら 2 つの点を取得したら、元のテキスト四角形の垂直線として機能する線を描画できます [注: これは真に垂直ではない可能性があります。上部の 50% が常に下部に 50% と並ぶとは限りません。 注の終了]

この新しい行を取得し、手順 4 から得た垂直方向の割合を上から下に従います。

これは、元のテキスト四角形の古いポイントの代わりに使用する必要がある新しいポイントです。

次に、テキスト本文内の各エンドポイントとコントロール ポイントに対して、これらの同じ手順を続けます。 (テキストの本文全体にのみ適用されます)

[注: Horizxontal percentages begin at 0.0 and continue to 1.0, left to right. 垂直方向のパーセンテージは 0.0 から始まり、上から下の 1.0 に進みます。 メモの終了]

[注: これは図形であるため、図形座標系とパス座標系の両方があります。 メモの終了]

親の要素
bodyPr (§21.1.2.1.1)

子要素	Subclause
avLst (図形の調整値の一覧)	§20.1.9.5

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

ISO/IEC29500: 2008。

コンストラクター

PresetTextWrap()	PresetTextWrap クラスの新しいインスタンスを初期化します。
PresetTextWrap(IEnumerable<OpenXmlElement>)	指定した子要素を使用して PresetTextWrap クラスの新しいインスタンスを初期化します。
PresetTextWrap(OpenXmlElement[])	指定した子要素を使用して PresetTextWrap クラスの新しいインスタンスを初期化します。
PresetTextWrap(String)	外部 XML から PresetTextWrap クラスの新しいインスタンスを初期化します。

プロパティ

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

メソッド

AddAnnotation(Object)	現在の OpenXmlElement 要素の注釈の一覧にオブジェクトを追加します。 (継承元 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	指定した要素が既知の子である場合は、 要素に追加します。 これにより、 要素がスキーマに従って正しい場所に追加されます。 (継承元 OpenXmlCompositeElement)
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)	現在の要素の子ノードのリストの末尾に、指定した要素を追加します。 (継承元 OpenXmlCompositeElement)
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)	指定した参照要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	現在の要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertAt<T>(T, Int32)	現在の要素の子の指定したインデックス位置に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	指定した参照要素の直前に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
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)	現在の要素の子ノードのリストの先頭に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
PreviousSibling()	現在の OpenXmlElement 要素のすぐ前にある OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PreviousSibling<T>()	現在の OpenXmlElement の前に指定された型を持つ OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
Remove()	現在の要素を親から削除します。 (継承元 OpenXmlElement)
RemoveAllChildren()	現在の要素のすべての子要素を削除します。 (継承元 OpenXmlCompositeElement)
RemoveAllChildren<T>()	T 型の現在の要素の子要素をすべて削除します。 (継承元 OpenXmlElement)
RemoveAnnotations(Type)	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAnnotations<T>()	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAttribute(String, String)	現在の要素から 属性を削除します。 (継承元 OpenXmlElement)
RemoveChild<T>(T)	指定した子要素を削除します。 (継承元 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	指定したプレフィックスの名前空間宣言を削除します。 プレフィックスがない場合は、何も削除しません。 (継承元 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	現在の要素の子要素の 1 つを別の OpenXmlElement 要素に置き換えます。 (継承元 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	指定した要素に属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	要素に複数の属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
WriteTo(XmlWriter)	現在のノードを指定した XmlWriter に保存します。 (継承元 OpenXmlElement)

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

IEnumerable.GetEnumerator()

プリセットテキストワープ。 このクラスは、Office 2007 以降で使用できます。 オブジェクトを xml としてシリアル化されるときに、修飾名は a:prstTxWarp です。 (継承元 OpenXmlElement)