Excel.TextFrame class
図形オブジェクトのテキスト フレームを表します。
- Extends
注釈
プロパティ
| auto |
テキスト フレームの自動サイズ設定。 テキストをテキスト フレームに自動的に合わせる、テキスト フレームをテキストに自動的に合わせる、自動サイズ変更を行わない、のいずれかにテキスト フレームを設定できます。 |
| bottom |
テキスト フレームの下余白を表します (ポイント数)。 |
| context | オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。 |
| has |
テキスト フレームにテキストが含まれているかどうかを指定します。 |
| horizontal |
テキスト フレームの水平方向の配置を表します。 詳細は「 |
| horizontal |
テキスト フレームの水平方向のオーバーフローの動作を表します。 詳細は「 |
| left |
テキスト フレームの左余白を表します (ポイント数)。 |
| orientation | テキスト フレームのテキストの向きを表す角度を表します。 詳細は「 |
| reading |
テキスト フレームの読む方向を表します (左から右または右から左)。 詳細は「 |
| right |
テキスト フレームの右余白を表します (ポイント数)。 |
| text |
テキスト フレーム内の図形にアタッチされているテキスト、およびテキストを操作するためのプロパティとメソッドを表します。 詳細は「 |
| top |
テキスト フレームの上余白を表します (ポイント数)。 |
| vertical |
テキスト フレームの垂直方向の配置を表します。 詳細は「 |
| vertical |
テキスト フレームの垂直方向のオーバーフローの動作を表します。 詳細は「 |
メソッド
| delete |
テキスト フレーム内のテキストをすべて削除します。 |
| load(options) | オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| set(properties, options) | オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクトまたは同じ型の別の API オブジェクトを渡すことができます。 |
| set(properties) | 既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。 |
| toJSON() | API オブジェクトが に渡されたときにより便利な出力を提供するために、JavaScript |
プロパティの詳細
autoSizeSetting
テキスト フレームの自動サイズ設定。 テキストをテキスト フレームに自動的に合わせる、テキスト フレームをテキストに自動的に合わせる、自動サイズ変更を行わない、のいずれかにテキスト フレームを設定できます。
autoSizeSetting: Excel.ShapeAutoSize | "AutoSizeNone" | "AutoSizeTextToFitShape" | "AutoSizeShapeToFitText" | "AutoSizeMixed";プロパティ値
Excel.ShapeAutoSize | "AutoSizeNone" | "AutoSizeTextToFitShape" | "AutoSizeShapeToFitText" | "AutoSizeMixed"
注釈
bottomMargin
context
オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。
context: RequestContext;プロパティ値
hasText
テキスト フレームにテキストが含まれているかどうかを指定します。
readonly hasText: boolean;プロパティ値
boolean
注釈
horizontalAlignment
テキスト フレームの水平方向の配置を表します。 詳細は「Excel.ShapeTextHorizontalAlignment」をご覧ください。
horizontalAlignment: Excel.ShapeTextHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed";プロパティ値
Excel.ShapeTextHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed"
注釈
horizontalOverflow
テキスト フレームの水平方向のオーバーフローの動作を表します。 詳細は「Excel.ShapeTextHorizontalOverflow」をご覧ください。
horizontalOverflow: Excel.ShapeTextHorizontalOverflow | "Overflow" | "Clip";プロパティ値
Excel.ShapeTextHorizontalOverflow | "Overflow" | "Clip"
注釈
leftMargin
orientation
テキスト フレームのテキストの向きを表す角度を表します。 詳細は「Excel.ShapeTextOrientation」をご覧ください。
orientation: Excel.ShapeTextOrientation | "Horizontal" | "Vertical" | "Vertical270" | "WordArtVertical" | "EastAsianVertical" | "MongolianVertical" | "WordArtVerticalRTL";プロパティ値
Excel.ShapeTextOrientation | "Horizontal" | "Vertical" | "Vertical270" | "WordArtVertical" | "EastAsianVertical" | "MongolianVertical" | "WordArtVerticalRTL"
注釈
readingOrder
テキスト フレームの読む方向を表します (左から右または右から左)。 詳細は「Excel.ShapeTextReadingOrder」をご覧ください。
readingOrder: Excel.ShapeTextReadingOrder | "LeftToRight" | "RightToLeft";プロパティ値
Excel.ShapeTextReadingOrder | "LeftToRight" | "RightToLeft"
注釈
rightMargin
textRange
テキスト フレーム内の図形にアタッチされているテキスト、およびテキストを操作するためのプロパティとメソッドを表します。 詳細は「Excel.TextRange」をご覧ください。
readonly textRange: Excel.TextRange;プロパティ値
注釈
topMargin
verticalAlignment
テキスト フレームの垂直方向の配置を表します。 詳細は「Excel.ShapeTextVerticalAlignment」をご覧ください。
verticalAlignment: Excel.ShapeTextVerticalAlignment | "Top" | "Middle" | "Bottom" | "Justified" | "Distributed";プロパティ値
Excel.ShapeTextVerticalAlignment | "Top" | "Middle" | "Bottom" | "Justified" | "Distributed"
注釈
verticalOverflow
テキスト フレームの垂直方向のオーバーフローの動作を表します。 詳細は「Excel.ShapeTextVerticalOverflow」をご覧ください。
verticalOverflow: Excel.ShapeTextVerticalOverflow | "Overflow" | "Ellipsis" | "Clip";プロパティ値
Excel.ShapeTextVerticalOverflow | "Overflow" | "Ellipsis" | "Clip"
注釈
メソッドの詳細
deleteText()
テキスト フレーム内のテキストをすべて削除します。
deleteText(): void;戻り値
void
注釈
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-textboxes.yaml
await Excel.run(async (context) => {
const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
const textbox = shapes.getItem("Textbox");
textbox.textFrame.deleteText();
await context.sync();
});
load(options)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(options?: Excel.Interfaces.TextFrameLoadOptions): Excel.TextFrame;パラメーター
読み込むオブジェクトのプロパティのオプションを提供します。
戻り値
load(propertyNames)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(propertyNames?: string | string[]): Excel.TextFrame;パラメーター
- propertyNames
-
string | string[]
読み込むプロパティを指定するコンマ区切り文字列または文字列の配列。
戻り値
load(propertyNamesAndPaths)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.TextFrame;パラメーター
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select は、読み込むプロパティを指定するコンマ区切り文字列で propertyNamesAndPaths.expand 、読み込むナビゲーション プロパティを指定するコンマ区切りの文字列です。
戻り値
set(properties, options)
オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクトまたは同じ型の別の API オブジェクトを渡すことができます。
set(properties: Interfaces.TextFrameUpdateData, options?: OfficeExtension.UpdateOptions): void;パラメーター
- properties
- Excel.Interfaces.TextFrameUpdateData
メソッドが呼び出されるオブジェクトのプロパティに等形的に構造化されたプロパティを持つ JavaScript オブジェクト。
- options
- OfficeExtension.UpdateOptions
properties オブジェクトが読み取り専用プロパティを設定しようとした場合にエラーを抑制するオプションを提供します。
戻り値
void
set(properties)
既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。
set(properties: Excel.TextFrame): void;パラメーター
- properties
- Excel.TextFrame
戻り値
void
toJSON()
API オブジェクトが に渡されたときにより便利な出力を提供するために、JavaScript toJSON() メソッドを JSON.stringify()オーバーライドします。 (JSON.stringifyさらに、渡される オブジェクトの メソッドを呼び出 toJSON します)。元の Excel.TextFrame オブジェクトは API オブジェクトですが、メソッドは、元の toJSON オブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト (として Excel.Interfaces.TextFrameData型指定) を返します。
toJSON(): Excel.Interfaces.TextFrameData;戻り値
Office Add-ins
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示