データのグラフィック表示について (Visio)

[アーティクル]
04/07/2023

メモデータ接続機能は、Microsoft Visio Professional 2013のライセンスを持つユーザーのみが使用できます。

Visio でのデータ接続には、4 つの側面があります。

データファイルに接続する
図形のデータにリンクする
リンクされたデータのグラフィック表示
データソースで変更されたリンク済みデータの更新、リンクされた図形の更新、以後に発生する可能性のある競合の解決

通常は、ここに示される順序でこれらの側面にアプローチします。つまり、最初に Visio 図面をデータソースに接続し、次に図面に含まれる図形をデータソース内のデータにリンクさせ、その図形のデータをグラフィック表示し、必要に応じてリンクされたデータを更新します。 Visio オブジェクトモデルには、上記の 4 つの側面それぞれについて、関連する新しいオブジェクトやメンバーがあります。このトピックは、第 3 および第 4 の、リンクされたデータを Visio の図形内にグラフィック表示すること、データを更新することに関するものです。データ接続の他の側面については次のトピックを参照してください。

リンクされたデータをプログラムで表示するには、データ表示用の Visio API が使えます。次のようなオブジェクトと関連するメンバーがあります。

GraphicItems コレクション
GraphicItem オブジェクト

Visio 図面内の図形をデータレコードセットの行にリンクすると、リンク先のデータをプログラムでグラフィック表示できます。たとえば図面内に、データにリンクする図形がいくつかあって、それぞれがプロジェクトの各段階の進行状況を表しているとします。この場合、特定の図形データのアイテムに、進行状況バーを関連付けることができます。その後、進行状況バーをプロジェクト図形の選択に適用し、各プロジェクトの完了に向けた進行状況を視覚的に表示できます。

データグラフィックとグラフィックアイテムの概要

データをグラフィカルに表示しやすくするために、Visio では、データグラフィックの概念と、データ グラフィックマスターと呼ばれる Master オブジェクトの種類が導入されています。これは VisMasterTypes 列挙で visTypeDataGraphic 値で表されます。 visTypeDataGraphic 型の Master オブジェクトを Masters コレクションに追加するには、Masters.AddEx メソッドを使用する必要があります。

Visio には何種類かのマスターがありますが、図形マスターもその 1 つです。図形マスターから作成したインスタンスは図形になります。 Visio には塗りつぶしのパターン、線パターン、線端というマスターもありますが、そのインスタンスを作成することはできません。このようなマスターを図形に適用することにより、マスターパターンを図形に付与することができます。データグラフィックマスターは、そのインスタンスを作成しないため、パターンマスターに似ています。線パターンや塗りつぶしのパターンと同様に、図形に適用することは可能です。

データグラフィックマスターは、Visio UI の [データグラフィックス] 作業ウィンドウに表示される データグラフィックス に対応します。データグラフィックマスターは、1 つ以上の グラフィック項目で構成されます。グラフィックアイテムは、定義したルールに基づいて、指定した図形を基準にした位置に、図形データに関連付けることができる、既製のビジュアルコンポーネントとして設計された Visio 図形です。

Visio には次のような種類のグラフィックアイテムがあります。

テキスト 図形を基準にして指定した位置に、吹き出し内のテキストとしてデータを表示します。
値による色 図形データと特定の値または値の範囲の比較に基づいて、図形の色を変更します。
データバー 棒グラフとグラフを使用して、図形を基準にして指定した位置にデータを表示します。
アイコンセット 図形を基準にして指定した位置に、データ値または条件を表すアイコンのセットの 1 つを表示します。

Visio には、グラフィックアイテムに初めから組み込まれている、さまざまな標準データグラフィックがあります。図形に初めから組み込まれているグラフィックアイテムとは別のデータグラフィックを適用したい場合は、カスタムデータグラフィックを作成してください。 Visio UI を使用しててデータグラフィックを作成し、そこにグラフィックアイテムを追加するようお勧めします。

UI でデータグラフィックスを作成するには

[データ] タブで、[データグラフィック] をクリックします。
[新しいデータグラフィックの作成] をクリックし、[新しいデータグラフィック] ダイアログボックスで [新しいアイテム] をクリックします。
ダイアログボックスが開いたら、アイテムをカスタマイズし、同じ手順でカスタムアイテムを追加します。

データグラフィックマスターを作成し、プログラムで既存のグラフィックアイテムに組み込むこともできます。グラフィックアイテムをプログラムで作成することはできませんが、既存のデータグラフィックの動作をカスタマイズすることはできます。さらに、コードを使用してグラフィックアイテムの動作や位置を変更することもできますし、Expression と呼ばれる、個々のグラフィックアイテムがどのようにデータを表示するかを定義するルールも同様です。式は、ShapeSheet の数式であっても、他の有効な ShapeSheet 式や図形データ (カスタムプロパティ) ラベルであってもかまいません。図形データラベルである式を設定するには、ラベルを中かっこ ({}) で囲み、GraphicItem.SetExpression メソッドの 2 番目の ( Expression) パラメーターとして渡す必要があります。

独自の組み合わせのグラフィックアイテムを組み込み、その動作も定義してデータグラフィックを作成すると、これをプログラムでデータにリンクされた図形に適用することができます。

データグラフィックに関するオブジェクトとメンバ

前節で説明した、visTypeDataGraphic という種類の Master オブジェクトに加え、Visio のデータグラフィック API には、次のようなオブジェクトや関連したメンバーがあります。

GraphicItems コレクション
GraphicItem オブジェクト

これは特にデータグラフィックを操作するために用意されたオブジェクトやメンバーですが、Visio にはほかにも、データグラフィック API を構成するオブジェクトがいくつかあります。たとえば、 Shape.DataGraphic プロパティと Selection.DataGraphic プロパティを使用すると、それぞれ図形と選択範囲にデータグラフィックを適用できます。読み取り専用 の Shape.IsDataGraphicCallout プロパティは、特定の図形が図面内のデータグラフィックアイテムとして機能しているかどうかを示します。

データグラフィックをデータにリンクした図形に適用する

次の例は、Selection.DataGraphic プロパティを使用して、UI 上で作成した既存のカスタムデータグラフィックを、図面上の選択した図形に適用する方法を示します。このコードを機能させるには、既存のカスタムデータグラフィックに "MyCustomDataGraphic" という名前を付ける必要があります。または、図面の既存のデータグラフィックの名前を、コード内の "MyCustomDataGraphic" に置き換えることもできます。

Public Sub ApplyDataGraphic() 
    Dim vsoSelection As Visio.Selection 
    ActiveWindow.SelectAll 
    Set vsoSelection = ActiveWindow.Selection 
    Set vsoSelection.DataGraphic = ActiveDocument.Masters("MyCustomDataGraphic") 
End Sub

データグラフィックマスターの動作をカスタマイズする

Master.DataGraphicHidden プロパティと Master.DataGraphicHidesText プロパティを使用して、データグラフィックマスターの動作の特定の側面をカスタマイズします。

DataGraphicHidden プロパティは、データグラフィックマスターを、Visio UI の [データグラフィック] ギャラリーに表示するかどうかを表します。このプロパティの値を True に設定すると、該当するマスターは、ギャラリー内のデータグラフィックのリストに表示されません。このプロパティの既定値は False です。

DataGraphicsHidesText プロパティは、データグラフィックマスターを適用することにより、図形そのもののテキスト (グループ図形であれば 1 次図形のテキスト) が隠れるかどうかを表します。このプロパティの既定値も False です。

GraphicItem.UseDataGraphicPosition プロパティは、グラフィックアイテムが属する GraphicItems コレクションのデータグラフィックマスターのグラフィックアイテムに対して、現在の既定の吹き出し位置を使用するかどうかを決定します。 visTypeDataGraphic 型の Master オブジェクトの GraphicItems コレクション内のグラフィックアイテムの既定の吹き出し位置は、Master.DataGraphicVerticalPosition プロパティと Master.DataGraphicHorizontalPosition プロパティの設定によって指定されます。 UseDataGraphicPosition が True の場合、グラフィックアイテムは既定の設定に従って配置されます。 UseDataGraphicPosition が False の場合、その位置は Graphic Item.VerticalPosition プロパティと GraphicItem.HorizontalPosition プロパティの設定によって決まります。

また、グラフィックアイテムの HorizontalPosition プロパティと VerticalPosition プロパティの各値が、DataGraphicHorizontalPosition プロパティと DataGraphicVerticalPosition プロパティの各値と等しい場合は、グラフィックアイテムの UseDataGraphicPosition プロパティの値は、自動的に True に設定されます。

ただし、図形に適用されたデータグラフィックの位置は、ユーザーがデータグラフィックのハンドルを操作して手動で再設定できます。この方法で設定された位置は、プロパティ設定で指定された位置より優先されます。

Master.DataGraphicShowBorder プロパティは、データグラフィックを適用する図形を基準に、既定の位置にあるグラフィック項目の周囲に罫線を表示するかどうかを決定します。既定では、罫線は非表示になります。

プログラムでデータグラフィックをまとめる

次の例は、データグラフィックマスターを作成し、これに既存のグラフィックアイテムを追加し、そのグラフィックアイテムを修正する方法を示します。この例では Masters.AddEx メソッドを使って、新しいデータグラフィックマスターを、現在のドキュメントの Masters コレクションに追加します。

次に、Master.Open メソッドを使用して、既存のデータグラフィックのマスターシェイプのコピーを取得して編集します。マスターシェイプ自体の代わりにマスターシェイプのコピーを編集する必要がある理由の詳細については、Open メソッドを参照してください。次に、 GraphicItems.AddCopy メソッドを使用して、既存のグラフィック項目のコピーを新しいマスターの GraphicItems コレクションに追加し、 GraphicItem.SetExpression メソッドを使用してグラフィック項目が表すデータフィールドを変更します。さらに、GraphicItem.PositionHorizontal プロパティを設定して、グラフィックアイテムの左右方向の相対位置 (これが適用される図形を基準とした位置) を変更します。

最後に、 Master.DataGraphicHidesText プロパティを True に設定して図形のテキストを非表示にし、マスターシェイプのコピーを閉じます。このプロパティは、このデータグラフィックマスターが適用されている既存の図形に変更を適用します。その後、新しいデータグラフィックマスターを追加の図形に適用できます。

Public Sub AddNewDataGraphicMaster() 
 
    Dim vsoMaster As Visio.Master 
    Dim vsoMasterCopy As Visio.Master 
    Dim vsoMaster_Old As Visio.Master 
    Dim vsoGraphicItem As GraphicItem 
    Dim vsoGraphicItem_Old As Visio.GraphicItem 
 
    Set vsoMaster = ActiveDocument.Masters.AddEx(visTypeDataGraphic) 
    Set vsoMasterCopy = vsoMaster.Open 
    Set vsoMaster_Old = ActiveDocument.Masters("old_master_name") 
    Set vsoGraphicItem_Old = vsoMaster_Old.GraphicItems(1) 
    Set vsoGraphicItem = vsoMasterCopy.GraphicItems.AddCopy(vsoGraphicItem_Old) 
 
    vsoGraphicItem.SetExpression visGraphicExpression, "new_data_field_name" 
    vsoGraphicItem.PositionHorizontal = visGraphicLeft 
    vsoMasterCopy.DataGraphicHidesText = True; 
    vsoMasterCopy.Close 
 
End Sub

先のコード例は、既存のデータグラフィックマスターの名前 (新しいマスターに追加しようとしている 1 つ以上のグラフィックアイテムが含まれるもの) と、マスターに追加しようとしている各グラフィックアイテムの ID がわかっていると想定しています。既存のデータグラフィックのマスターシェイプ名は、[データグラフィック] 作業ウィンドウのマスターシェイプの上にマウスポインターを置いて確認できます。また、マスター名と ID も、次のコードのように、現在のドキュメントの Masters コレクションについて繰り返すことにより確認することができます。

For intCounter = 1 To ActiveDocument.Masters.Count 
        If ActiveDocument.Masters(intCounter).Type = visTypeDataGraphic Then 
            Debug.Print ActiveDocument.Masters(intCounter).Name, ActiveDocument.Masters(intCounter).ID 
        End If 
    Next

同様に、次の例に示すように、マスターの GraphicItems コレクションを反復処理して、既存のグラフィックアイテムの ID プロパティと Tag プロパティの値を決定できます。 Tag プロパティは単なる文字列であって、Visio がその値を使用することはありません。既定では空です。何らかの値を設定しておくと、個々のグラフィックアイテムをプログラムで容易に識別できます。

For intCounter = 1 To (vsoMaster_Old.GraphicItems.Count) 
        Debug.Print vsoMaster_Old.GraphicItems(intCounter).ID, oldMaster.GraphicItems(intCounter).Tag 
    Next

データグラフィックスをプログラムでカスタマイズする方法を示すコードサンプルを表示するには、Visio SDK をダウンロードし、コードサンプルライブラリを参照してください。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。

次の方法で共有

データのグラフィック表示について (Visio)

データグラフィックとグラフィックアイテムの概要

UI でデータグラフィックスを作成するには

データグラフィックに関するオブジェクトとメンバ

データグラフィックをデータにリンクした図形に適用する

データグラフィックマスターの動作をカスタマイズする

プログラムでデータグラフィックをまとめる

サポートとフィードバック

フィードバック

その他のリソース

次の方法で共有

データのグラフィック表示について (Visio)

データ グラフィックとグラフィック アイテムの概要

UI でデータ グラフィックスを作成するには

データ グラフィックに関するオブジェクトとメンバ

データ グラフィックをデータにリンクした図形に適用する

データ グラフィック マスターの動作をカスタマイズする

プログラムでデータ グラフィックをまとめる

サポートとフィードバック

フィードバック

その他のリソース

データグラフィックとグラフィックアイテムの概要

UI でデータグラフィックスを作成するには

データグラフィックに関するオブジェクトとメンバ

データグラフィックをデータにリンクした図形に適用する

データグラフィックマスターの動作をカスタマイズする

プログラムでデータグラフィックをまとめる