図形の操作

このトピックでは、Aspose.Wordsを使用して図形をプログラムで操作する方法について説明します。

Aspose.Wordsの図形は、AutoShape、textbox、freeform、OLEオブジェクト、ActiveXコントロール、または画像など、描画レイヤー内のオブジェクトを表します。 Word文書には、1つ以上の異なる図形を含めることができます。 ドキュメントの図形はShapeクラスで表されます。

ドキュメントビルダーを使用した図形の挿入

InsertShape メソッドを使用して、タイプとサイズが指定されたインライン シェイプと、位置、サイズ、テキスト折り返しタイプが指定されたフリー フローティング シェイプをドキュメントに挿入できます。InsertShape メソッドを使用すると、ドキュメント モデルに DML シェイプを挿入できます。ドキュメントは、DML シェイプをサポートする形式で保存する必要があります。そうでない場合、ドキュメントの保存時に、このようなノードは VML シェイプに変換されます。

次のコード例は、これらの種類の図形をドキュメントに挿入する方法を示しています:

ロックされたアスペクト比を設定

Aspose.Wordsを使用すると、図形のアスペクト比をAspectRatioLockedプロパティでロックするかどうかを指定できます。

次のコード例は、AspectRatioLockedプロパティを操作する方法を示しています:

セル内の図形レイアウトを設定する

また、IsLayoutInCellプロパティを使用して、図形をテーブルの内側に表示するか、テーブルの外側に表示するかを指定することもできます。

次のコード例は、IsLayoutInCellプロパティを操作する方法を示しています:

角切りを追加

Aspose.Wordsを使用してスニップ角矩形を作成することができます。 図形の種類は*SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded,とDiagonalCornersRounded.*です

DML図形は、これらの図形タイプのInsertShapeメソッドを使用して作成されます。 これらの型を使用してVML図形を作成することはできません。 “Shape"クラスのパブリックコンストラクタを使用してshapeを作成しようとすると、“NotSupportedException"例外が発生します。

次のコード例は、これらの種類の図形をドキュメントに挿入する方法を示しています:

実際の形状の境界点を取得する

Aspose.WordsAPIを使用すると、一番上の図形のアンカーを基準にして、ブロックを含む図形の位置とサイズをポイント単位で取得できます。 これを行うには、BoundsInPointsプロパティを使用します。

次のコード例は、BoundsInPointsプロパティを操作する方法を示しています:

縦のアンカーを指定して下さい

VerticalAnchorプロパティを使用して、図形内のテキストの垂直方向の配置を指定できます。

次のコード例は、VerticalAnchorプロパティを操作する方法を示しています:

SmartArt形状の検出

Aspose.Wordsは、図形にSmartArtオブジェクトがあるかどうかを検出することもできます。 これを行うには、HasSmartArtプロパティを使用します。

次のコード例は、HasSmartArtプロパティを操作する方法を示しています:

水平ルール形式

InsertHorizontalRuleメソッドを使用して、水平ルール形状を文書に挿入できます。

Aspose.WordsAPIは、水平ルール図形のプロパティにアクセスするためのHorizontalRuleFormatプロパティを提供します。 HorizontalRuleFormatクラスは、Height、Color、NoShadeなどの基本的なプロパティを公開します。 水平ルールの書式設定のために。

次のコード例は、HorizontalRuleFormatを設定する方法を示しています: