Visio (的 Selection.LinkToData 方法)

會將圖形的選取範圍連結至資料錄集中的單一資料列。

注意事項

This Visio object or member is available only to licensed users of Visio Professional 2013.

語法

expression。 LinkToData( _DataRecordsetID_ , _DataRowID_ , _AutoApplyDataGraphics_ )

表達 會傳回 Selection 物件的運算式。

參數

名稱	必要/選用	資料類型	描述
DataRecordsetID	必要	Long	包含要連結之資料的資料記錄集識別碼。
DataRowID	必要	Long	資料錄集內資料列的識別碼，此資料錄集包含要連結的特定資料錄。
AutoApplyDataGraphics	選用	布林值	是否要自動將資料圖形套用到連結的圖形。 如需詳細資訊，請參閱＜備註＞。

傳回值

無

註解

Selection.LinkToData 方法的作用與 Shape 物件的相同方法 Shape.LinkToData 非常類似，例外是它會將圖形的選取範圍 (而非單一圖形) 連結至單一資料列。

如果 Visio 無法建立圖形及資料列之間的連結，Visio 會略過該圖形，並繼續選取範圍中的下一個圖形。 執行 方法之後，若要判斷選取範圍中的所有圖形是否真的都連結到資料列，請在選取範圍中的每個圖形上呼叫 Shape.GetLinkedDataRow 方法。 如果該方法無法對任何圖形執行，它會表示圖形沒有連結至資料列。 Visio 通常會成功將資料列連結至圖形，除非圖形已連結至資料，而且資料記錄集的 link-replacement-behavior 設定會指定不應該取代連結。

如果您將 True 傳遞給 AutoApplyDataGraphics 參數，則 Visio 會將現有資料圖形重新套用至呼叫方法之前已套用資料圖形的圖形。 如果是先前沒有資料圖形的圖形，Visio 會套用目前文件中最近套用至任何其他圖形的資料圖形。

範例

下列 Microsoft Visual Basic for Applications (VBA) 巨集會示範如何使用 LinkToData 方法，來將選取範圍中的圖形連結至資料列。

執行此宏之前，請將數個圖形放在頁面上，並將至少一個資料記錄集新增至檔的 DataRecordsets 集合。 巨集會使用集合中最近新增之資料錄集的識別碼。 它會將選取的圖形連結至資料錄集第一列中的資料。

Public Sub LinkToData_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim vsoSelection As Visio.Selection 
    Dim intCount As Integer 
     
    intCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intCount) 
     
    ActiveWindow.DeselectAll 
    ActiveWindow.SelectAll 
     
    Set vsoSelection = ActiveWindow.Selection 
    vsoSelection.LinkToData vsoDataRecordset.ID, 1, True 
 
End Sub

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。