Page.DropIntoList 方法 (Visio)

將指定的物件放入指定的清單中置於指定的位置。會傳回剛放下的圖形。

語法

expression。 DropIntoList( _ObjectToDrop_ , _TargetList_ , _lPosition_ )

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

名稱	必要/選用	資料類型	描述
ObjectToDrop	必要	IUnknown	要放入清單中的圖形所在來源。可以是 Master、 Selection、 Shape或 IDataObject 物件。如需詳細資訊，請參閱＜備註＞。
TargetList	必要	圖形	要將 ObjectToDrop 放入其中的清單。
lPosition	必要	Long	圖形加入至清單中的位置，從 1 起算。

Shape

如果 ObjectToDrop 是 Selection 物件，該選取範圍可以只包含單一圖形。

如果 ObjectToDrop 是 IDataObject，其必須與本身所放入的頁面處於同一實例的本機 Microsoft Visio 物件相關聯。

如果 ObjectToDrop 不符合清單或容器的類別需求，Visio 會傳回不正確目標錯誤。圖形可以被指派類別，而容器則可有必要的類別和排除的類別。

類別是由使用者定義的字串，可用來將圖形分類進而限制容器內的成員資格。您可以在圖形的 ShapeSheet 中從 User.msvShapeCategories 儲存格來定義類別。若要為圖形定義多個類別，請以分號分隔各類別。

如果 ObjectToDrop 並非 Microsoft Visio 物件，或者沒有包含頁面上的最上層圖形，Microsoft Visio 將傳回「無效的參數」錯誤。

如果清單的 ContainerProperties.LockMembership 屬性為 True，Visio 會傳回 Disabled 錯誤。

下列 Visual Basic for Applications (VBA) 範例示範如何使用 DropIntoList 方法，將新圖形新增至使用中頁面上清單中清單的第一個位置。

Application.ActivePage.DropIntoList vsoMaster, vsoListShape, 1

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