SHAPETEXT 関数

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

構文

SHAPETEXT (shapename!TheText[,flag] )

パラメーター

名前	必須 / オプション	データ型	説明
shapename!TheText	必須		ターゲットとなる図形の [TheText] セルに対する参照を指定します。 Shapename! は、テキストを取得する図形の名前です。
flag	省略可能	数値	テキストの書式を示すビットを指定します。 既定のフラグ (0) は、図形に表示されるとおりにテキストを返します。

戻り値

文字列

注釈

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

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

例 1

SHAPETEXT(sheetN!theText)

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

例 2

SHAPETEXT(theText)

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

例 3

SHAPETEXT(theText, 84)

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