Word.Interfaces.ContentControlLoadOptions interface
コンテンツ コントロールを表します。 コンテンツ コントロールは、特定の種類のコンテンツのコンテナーとして機能し、ドキュメント内で境界線で区切られ、ラベルが付いた領域になる場合もあります。 個々のコンテンツ コントロールには、画像、テーブル、書式設定されたテキストの段落などのコンテンツが含まれていることがあります。 現時点では、リッチ テキスト、プレーン テキスト、およびチェック ボックス コンテンツ コントロールのみがサポートされています。
注釈
プロパティ
| $all | 読み込みオプションに |
| appearance | コンテンツ コントロールの外観を指定します。 値には、'BoundingBox'、'Tags'、または 'Hidden' を指定できます。 |
| cannot |
ユーザーがコンテンツ コントロールを削除できるかどうかを示す値を指定します。 removeWhenEdited と同時に使用することはできません。 |
| cannot |
ユーザーがコンテンツ コントロールの内容を編集できるかどうかを示す値を指定します。 |
| checkbox |
コンテンツ コントロールの種類が 'CheckBox' の場合は、チェック ボックスに関連するデータを指定します。 それ以外の場合は null です。 |
| color | コンテンツ コントロールの色を指定します。 色は、'#RRGGBB' 形式で指定するか、色名を使用して指定します。 |
| font | コンテンツ コントロールのテキストの書式設定を取得します。 これを使用して、フォント名、サイズ、色、およびその他のプロパティを取得および設定します。 |
| id | コンテンツ コントロールの識別子を表す整数値を取得します。 |
| parent |
コンテンツ コントロールの親の本文を取得します。 |
| parent |
コンテンツ コントロールを含むコンテンツ コントロールを取得します。 親コンテンツ コントロールがない場合は、 |
| parent |
コンテンツ コントロールを含むコンテンツ コントロールを取得します。 親コンテンツ コントロールがない場合、このメソッドは |
| parent |
コンテンツ コントロールを含むテーブルを取得します。 テーブルに含まれていない場合は、 |
| parent |
コンテンツ コントロールを含むテーブル セルを取得します。 テーブル セルに含まれていない場合は、 |
| parent |
コンテンツ コントロールを含むテーブル セルを取得します。 テーブル セルに含まれていない場合、このメソッドは |
| parent |
コンテンツ コントロールを含むテーブルを取得します。 テーブルに含まれていない場合、このメソッドは |
| placeholder |
コンテンツ コントロールのプレースホルダー テキストを指定します。 コンテンツ コントロールが空の場合は、淡色のテキストが表示されます。 注: このプロパティの設定操作は、Word on the web ではサポートされていません。 |
| remove |
コンテンツ コントロールが編集後に削除されるかどうかを示す値を指定します。 cannotDelete と同時に使用することはできません。 |
| style | コンテンツ コントロールのスタイル名を指定します。 カスタム スタイルとローカライズされたスタイルの名前には、このプロパティを使用します。 ロケール間で移植可能な組み込みスタイルを使用するには、"styleBuiltIn" プロパティを参照してください。 |
| style |
コンテンツ コントロールの組み込みスタイル名を指定します。 ロケール間で移植可能な組み込みスタイルの場合は、このプロパティを使用します。 カスタム スタイルまたはローカライズされたスタイルの名前を使用するには、"style" プロパティを参照してください。 |
| subtype | コンテンツ コントロールのサブタイプを取得します。 サブタイプは、リッチ テキスト コンテンツ コントロールの場合は 'RichTextInline'、'RichTextParagraphs'、'RichTextTableCell'、リッチ テキスト コンテンツ コントロールの場合は 'RichTextTableRow'、'RichTextTable'、プレーン テキスト コンテンツ コントロールの場合は 'PlainTextInline' と 'PlainTextParagraph'、チェックボックス コンテンツ コントロールの場合は 'CheckBox' です。 |
| tag | コンテンツ コントロールを識別するタグを指定します。 |
| text | コンテンツ コントロールのテキストを取得します。 |
| title | コンテンツ コントロールのタイトルを指定します。 |
| type | コンテンツ コントロールの種類を取得します。 現在サポートされているのは、リッチ テキスト、プレーン テキスト、チェックボックス コンテンツ コントロールのみです。 |
プロパティの詳細
$all
読み込みオプションに $all を指定すると、すべてのスカラー プロパティ ( Range.addressなど) が読み込まれますが、ナビゲーション プロパティ ( Range.format.fill.color など) は読み込まれません。
$all?: boolean;プロパティ値
boolean
appearance
コンテンツ コントロールの外観を指定します。 値には、'BoundingBox'、'Tags'、または 'Hidden' を指定できます。
appearance?: boolean;プロパティ値
boolean
注釈
cannotDelete
ユーザーがコンテンツ コントロールを削除できるかどうかを示す値を指定します。 removeWhenEdited と同時に使用することはできません。
cannotDelete?: boolean;プロパティ値
boolean
注釈
cannotEdit
ユーザーがコンテンツ コントロールの内容を編集できるかどうかを示す値を指定します。
cannotEdit?: boolean;プロパティ値
boolean
注釈
checkboxContentControl
コンテンツ コントロールの種類が 'CheckBox' の場合は、チェック ボックスに関連するデータを指定します。 それ以外の場合は null です。
checkboxContentControl?: Word.Interfaces.CheckboxContentControlLoadOptions;プロパティ値
注釈
color
コンテンツ コントロールの色を指定します。 色は、'#RRGGBB' 形式で指定するか、色名を使用して指定します。
color?: boolean;プロパティ値
boolean
注釈
font
コンテンツ コントロールのテキストの書式設定を取得します。 これを使用して、フォント名、サイズ、色、およびその他のプロパティを取得および設定します。
font?: Word.Interfaces.FontLoadOptions;プロパティ値
注釈
id
parentBody
コンテンツ コントロールの親の本文を取得します。
parentBody?: Word.Interfaces.BodyLoadOptions;プロパティ値
注釈
parentContentControl
コンテンツ コントロールを含むコンテンツ コントロールを取得します。 親コンテンツ コントロールがない場合は、 ItemNotFound エラーをスローします。
parentContentControl?: Word.Interfaces.ContentControlLoadOptions;プロパティ値
注釈
parentContentControlOrNullObject
コンテンツ コントロールを含むコンテンツ コントロールを取得します。 親コンテンツ コントロールがない場合、このメソッドは isNullObject プロパティを true に設定したオブジェクトを返します。 詳細については、「 *OrNullObject メソッドとプロパティ」を参照してください。
parentContentControlOrNullObject?: Word.Interfaces.ContentControlLoadOptions;プロパティ値
注釈
parentTable
コンテンツ コントロールを含むテーブルを取得します。 テーブルに含まれていない場合は、 ItemNotFound エラーをスローします。
parentTable?: Word.Interfaces.TableLoadOptions;プロパティ値
注釈
parentTableCell
コンテンツ コントロールを含むテーブル セルを取得します。 テーブル セルに含まれていない場合は、 ItemNotFound エラーをスローします。
parentTableCell?: Word.Interfaces.TableCellLoadOptions;プロパティ値
注釈
parentTableCellOrNullObject
コンテンツ コントロールを含むテーブル セルを取得します。 テーブル セルに含まれていない場合、このメソッドは isNullObject プロパティを true に設定したオブジェクトを返します。 詳細については、「 *OrNullObject メソッドとプロパティ」を参照してください。
parentTableCellOrNullObject?: Word.Interfaces.TableCellLoadOptions;プロパティ値
注釈
parentTableOrNullObject
コンテンツ コントロールを含むテーブルを取得します。 テーブルに含まれていない場合、このメソッドは isNullObject プロパティを true に設定したオブジェクトを返します。 詳細については、「 *OrNullObject メソッドとプロパティ」を参照してください。
parentTableOrNullObject?: Word.Interfaces.TableLoadOptions;プロパティ値
注釈
placeholderText
コンテンツ コントロールのプレースホルダー テキストを指定します。 コンテンツ コントロールが空の場合は、淡色のテキストが表示されます。
注: このプロパティの設定操作は、Word on the web ではサポートされていません。
placeholderText?: boolean;プロパティ値
boolean
注釈
removeWhenEdited
コンテンツ コントロールが編集後に削除されるかどうかを示す値を指定します。 cannotDelete と同時に使用することはできません。
removeWhenEdited?: boolean;プロパティ値
boolean
注釈
style
コンテンツ コントロールのスタイル名を指定します。 カスタム スタイルとローカライズされたスタイルの名前には、このプロパティを使用します。 ロケール間で移植可能な組み込みスタイルを使用するには、"styleBuiltIn" プロパティを参照してください。
style?: boolean;プロパティ値
boolean
注釈
styleBuiltIn
コンテンツ コントロールの組み込みスタイル名を指定します。 ロケール間で移植可能な組み込みスタイルの場合は、このプロパティを使用します。 カスタム スタイルまたはローカライズされたスタイルの名前を使用するには、"style" プロパティを参照してください。
styleBuiltIn?: boolean;プロパティ値
boolean
注釈
subtype
コンテンツ コントロールのサブタイプを取得します。 サブタイプは、リッチ テキスト コンテンツ コントロールの場合は 'RichTextInline'、'RichTextParagraphs'、'RichTextTableCell'、リッチ テキスト コンテンツ コントロールの場合は 'RichTextTableRow'、'RichTextTable'、プレーン テキスト コンテンツ コントロールの場合は 'PlainTextInline' と 'PlainTextParagraph'、チェックボックス コンテンツ コントロールの場合は 'CheckBox' です。
subtype?: boolean;プロパティ値
boolean
注釈
tag
text
title
type
コンテンツ コントロールの種類を取得します。 現在サポートされているのは、リッチ テキスト、プレーン テキスト、チェックボックス コンテンツ コントロールのみです。
type?: boolean;プロパティ値
boolean
注釈
Office Add-ins
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示