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 通常可成功將列連結連結至圖形。

如果您將 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 支援與意見反應。

  • 上次更新時間：