Office.CoercionType enum
呼び出されたメソッドによって返される、または設定されるデータを強制的に変換する方法を指定します。
注釈
各 CoercionType
のアプリケーションとプラットフォームのサポートは、次の要件セットの説明で指定します。
HtmlCoercion、(
Office.CoercionType.Html
を使用する場合)ImageCoercion 1.1 (
Office.CoercionType.Image
を使用する場合)MatrixCoercion (
Office.CoercionType.Matrix
を使用する場合)OoxmlCoercion (
Office.CoercionType.Ooxml
を使用する場合)TableCoercion (
Office.CoercionType.Table
を使用する場合)TextCoercion (
Office.CoercionType.Text
を使用する場合)ImageCoercion 1.2 (
Office.CoercionType.XmlSvg
を使用する場合)
例
// This function displays the currently selected text in the console.
// It uses the Common APIs.
function run() {
Office.context.document.getSelectedDataAsync(Office.CoercionType.Text, (asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.error(asyncResult.error.message);
} else {
console.log(`The selected data is "${asyncResult.value}".`);
}
});
}
フィールド
Html | データを HTML として取得または設定します。 注: Word 用アドインのデータと Outlook 用 Outlook アドイン (作成モード) にのみ適用されます。 |
Image | データは返されるか、イメージ ストリームとして設定されます。 注: Excel、Word、PowerPointのデータにのみ適用されます。 |
Matrix | データをヘッダーなしの表形式データとして取得または設定します。 データは、1 次元の一連の文字を含む配列の配列として取得または設定されます。 たとえば、2 つの列の文字列値の 3 行は、[["R1C1"、"R1C2"]、["R2C1"、"R2C2"]、["R3C1"、"R3C2"] です。 注: Excel と Word のデータにのみ適用されます。 |
Ooxml | データを Office Open XML として取得または設定します。 注: Word のデータにのみ適用されます。 |
SlideRange | 選択したスライドの ID、タイトル、インデックスの配列を含む JSON オブジェクトを返します。 たとえば、2 つのスライドの選択に 注: Document.getSelectedData メソッドを呼び出して現在のスライドまたは選択したスライド範囲を取得する場合、PowerPointのデータにのみ適用されます。 |
Table | データをヘッダー付き (省略可能) の表形式データとして取得または設定します。 データをヘッダー付き (省略可能) の表形式データとして取得または設定します。 注: Excel と Word のデータにのみ適用されます。 |
Text | データをテキスト (文字列) として返すか設定します。 データは、1 次元の一連の文字として取得または設定されます。 |
XmlSvg | データは、SVG イメージを含む XML データとして返されるか、設定されます。 注: Excel、Word、PowerPointのデータにのみ適用されます。 |
Office Add-ins