SHAPETEXT 関数

Microsoft Office Visio 2003 SDK ドキュメント

SHAPETEXT 関数

図形からテキストを取り出します。

SHAPETEXT (shapename!TheText,flag)

shapename!TheText ターゲットとなる図形の [TheText] セルに対する参照です。Shapename! はテキストを取り出す図形の名前です。

flag オプションです。テキストの書式を示すビットを指定します。既定のフラグ (0) は、図形に表示されるとおりにテキストを返します。

備考

SHAPETEXT 関数では、次のフラグを任意に組み合わせて使用できます。

フラグ 説明
0 図形に表示されているとおりにテキストを返します。
1 任意のハイフンを含みます。
2 フィールドの拡張テキストは除外されます。
4 タブを単一のスペースに変換します。
8 タブを複数のスペースに変換します。
16 改行文字と行送りをスペースに変換します。
32 印刷用の引用符を通常の引用符に変換します。
64 隣接した余白を単一のスペースに変換します。

例 1

SHAPETEXT(sheetN!theText)

図形に表示されているとおりに、sheetN という図形のテキストを返します。

例 2

SHAPETEXT(theText)

図形に表示されているとおりに、現在の図形のテキストを返します。

例 3

SHAPETEXT(theText, 84)

現在の図形のテキストを返します。隣接した余白から単一のスペースへの変換 (64)、改行文字と行送りのスペースへの変換 (16)、およびタブの単一のスペースへの変換 (4) も行います。これらのフラグの合計は 84 です。