Visio.Document class

ドキュメント クラスを表します。

Extends

プロパティ

application

このドキュメントを含む Visio アプリケーションのインスタンスを表します。

context

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

pages

ドキュメントに関連付けられているページのコレクションを表します。

view

DocumentView オブジェクトを返します。

メソッド

getActivePage()

ドキュメントのアクティブ ページを返します。

load(options)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

set(properties, options)

オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクト、または同じ型の別の API オブジェクトを渡すことができます。

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。

setActivePage(PageName)

ドキュメントのアクティブ ページを設定します。

showTaskPane(taskPaneType, initialProps, show)

タスク ウィンドウを表示または非表示にします。 これは、Visio の図面を埋め込んで作業ウィンドウを表示/非表示にする DV Excel アドイン/その他のサード パーティ製アプリによって使用されます。

showTaskPane(taskPaneType, initialProps, show)

タスク ウィンドウを表示または非表示にします。 これは、Visio の図面を埋め込んで作業ウィンドウを表示/非表示にする DV Excel アドイン/その他のサード パーティ製アプリによって使用されます。

startDataRefresh()

すべてのページについて、図内のデータの更新をトリガーします。

toJSON()

API オブジェクトが JSON.stringify() に渡されるときに、より有用な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (JSON.stringify は、渡されたオブジェクトの toJSON メソッドを呼び出します)。元の Visio.Document オブジェクトが API オブジェクトであるのに対し、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Visio.Interfaces.DocumentData 型) を返します。

イベント

onDataRefreshComplete

ダイアグラムのデータが更新されたときに発生します。

onDocumentError

セッションで予期されたエラー、または予期しないエラーが発生した場合に発生します。

onDocumentLoadComplete

ドキュメントの読み込み、更新、または変更時に発生します。

onPageLoadComplete

ページの読み込みが完了したときに発生します。

onSelectionChanged

現在選択されている図形が変更されたときに発生します。

onShapeMouseEnter

ユーザーが図形の境界ボックスにマウス ポインターを移動したときに発生します。

onShapeMouseLeave

ユーザーが図形の境界ボックスの外にマウスを移動したときに発生します。

onTaskPaneStateChanged

作業ウィンドウの状態が変更されるたびに発生します。

プロパティの詳細

application

このドキュメントを含む Visio アプリケーションのインスタンスを表します。

readonly application: Visio.Application;

プロパティ値

注釈

API セット: 1.1

context

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

context: RequestContext;

プロパティ値

pages

ドキュメントに関連付けられているページのコレクションを表します。

readonly pages: Visio.PageCollection;

プロパティ値

注釈

API セット: 1.1

Visio.run(session, function (ctx) {
    const pages = ctx.document.pages;
    const pageCount = pages.getCount();
    return ctx.sync().then(function () {
        console.log("Pages Count: " +pageCount.value);
    });
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});

view

DocumentView オブジェクトを返します。

readonly view: Visio.DocumentView;

プロパティ値

注釈

API セット: 1.1

メソッドの詳細

getActivePage()

ドキュメントのアクティブ ページを返します。

getActivePage(): Visio.Page;

返品

注釈

API セット: 1.1

Visio.run(session, function (ctx) {
    const document = ctx.document;
    const activePage = document.getActivePage();
    activePage.load("name");
    return ctx.sync().then(function () {
        console.log("pageName: " +activePage.name);
    });   
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});

load(options)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(options?: Visio.Interfaces.DocumentLoadOptions): Visio.Document;

パラメーター

options
Visio.Interfaces.DocumentLoadOptions

読み込むオブジェクトのプロパティのオプションを指定します。

返品

load(propertyNames)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames?: string | string[]): Visio.Document;

パラメーター

propertyNames

string | string[]

読み込むプロパティを指定するコンマ区切りの文字列または文字列の配列。

返品

load(propertyNamesAndPaths)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Visio.Document;

パラメーター

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select は読み込むプロパティを指定するコンマ区切りの文字列であり、 propertyNamesAndPaths.expand は読み込むナビゲーションのプロパティを指定するコンマ区切りの文字列です。

返品

set(properties, options)

オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクト、または同じ型の別の API オブジェクトを渡すことができます。

set(properties: Interfaces.DocumentUpdateData, options?: OfficeExtension.UpdateOptions): void;

パラメーター

properties
Visio.Interfaces.DocumentUpdateData

メソッドが呼び出されたオブジェクトのプロパティと同型構造のプロパティを持つ JavaScript オブジェクト。

options
OfficeExtension.UpdateOptions

プロパティ オブジェクトが読み取り専用プロパティを設定しようとした場合にエラーを抑制するオプションを提供します。

返品

void

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。

set(properties: Visio.Document): void;

パラメーター

properties
Visio.Document

返品

void

setActivePage(PageName)

ドキュメントのアクティブ ページを設定します。

setActivePage(PageName: string): void;

パラメーター

PageName

string

ページの名前です。

返品

void

注釈

API セット: 1.1

Visio.run(session, function (ctx) {
    const document = ctx.document;
    const pageName = "Page-1";
    document.setActivePage(pageName);
    return ctx.sync();
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});

showTaskPane(taskPaneType, initialProps, show)

タスク ウィンドウを表示または非表示にします。 これは、Visio の図面を埋め込んで作業ウィンドウを表示/非表示にする DV Excel アドイン/その他のサード パーティ製アプリによって使用されます。

showTaskPane(taskPaneType: Visio.TaskPaneType, initialProps?: any, show?: boolean): void;

パラメーター

taskPaneType
Visio.TaskPaneType

ファースト パーティのタスク ペインの種類。 列挙型から値を取得できます TaskPaneType

initialProps

any

オプションのパラメーター。 これは汎用データ構造であり、作業ウィンドウの内容を初期化するために必要な初期データで格納されます。

show

boolean

オプションのパラメーター。 false に設定すると、指定した作業ウィンドウが非表示になります。

返品

void

注釈

API セット: 1.1

showTaskPane(taskPaneType, initialProps, show)

タスク ウィンドウを表示または非表示にします。 これは、Visio の図面を埋め込んで作業ウィンドウを表示/非表示にする DV Excel アドイン/その他のサード パーティ製アプリによって使用されます。

showTaskPane(taskPaneType: "None" | "DataVisualizerProcessMappings" | "DataVisualizerOrgChartMappings", initialProps?: any, show?: boolean): void;

パラメーター

taskPaneType

"None" | "DataVisualizerProcessMappings" | "DataVisualizerOrgChartMappings"

ファースト パーティのタスク ペインの種類。 列挙型から値を取得できます TaskPaneType

initialProps

any

オプションのパラメーター。 これは汎用データ構造であり、作業ウィンドウの内容を初期化するために必要な初期データで格納されます。

show

boolean

オプションのパラメーター。 false に設定すると、指定された作業ウィンドウが非表示になります。

返品

void

注釈

API セット: 1.1

startDataRefresh()

すべてのページについて、図内のデータの更新をトリガーします。

startDataRefresh(): void;

返品

void

注釈

API セット: 1.1

Visio.run(session, function (ctx) {
    const document = ctx.document;
    document.startDataRefresh();
    return ctx.sync();
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});

toJSON()

API オブジェクトが JSON.stringify() に渡されるときに、より有用な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (JSON.stringify は、渡されたオブジェクトの toJSON メソッドを呼び出します)。元の Visio.Document オブジェクトが API オブジェクトであるのに対し、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Visio.Interfaces.DocumentData 型) を返します。

toJSON(): Visio.Interfaces.DocumentData;

返品

イベントの詳細

onDataRefreshComplete

ダイアグラムのデータが更新されたときに発生します。

readonly onDataRefreshComplete: OfficeExtension.EventHandlers<Visio.DataRefreshCompleteEventArgs>;

イベントの種類

注釈

API セット: 1.1

onDocumentError

セッションで予期されたエラー、または予期しないエラーが発生した場合に発生します。

readonly onDocumentError: OfficeExtension.EventHandlers<Visio.DocumentErrorEventArgs>;

イベントの種類

注釈

API セット: 1.1

onDocumentLoadComplete

ドキュメントの読み込み、更新、または変更時に発生します。

readonly onDocumentLoadComplete: OfficeExtension.EventHandlers<Visio.DocumentLoadCompleteEventArgs>;

イベントの種類

注釈

API セット: 1.1

onPageLoadComplete

ページの読み込みが完了したときに発生します。

readonly onPageLoadComplete: OfficeExtension.EventHandlers<Visio.PageLoadCompleteEventArgs>;

イベントの種類

注釈

API セット: 1.1

onSelectionChanged

現在選択されている図形が変更されたときに発生します。

readonly onSelectionChanged: OfficeExtension.EventHandlers<Visio.SelectionChangedEventArgs>;

イベントの種類

注釈

API セット: 1.1

onShapeMouseEnter

ユーザーが図形の境界ボックスにマウス ポインターを移動したときに発生します。

readonly onShapeMouseEnter: OfficeExtension.EventHandlers<Visio.ShapeMouseEnterEventArgs>;

イベントの種類

注釈

API セット: 1.1

onShapeMouseLeave

ユーザーが図形の境界ボックスの外にマウスを移動したときに発生します。

readonly onShapeMouseLeave: OfficeExtension.EventHandlers<Visio.ShapeMouseLeaveEventArgs>;

イベントの種類

注釈

API セット: 1.1

onTaskPaneStateChanged

作業ウィンドウの状態が変更されるたびに発生します。

readonly onTaskPaneStateChanged: OfficeExtension.EventHandlers<Visio.TaskPaneStateChangedEventArgs>;

イベントの種類

注釈

API セット: 1.1