Visio) (ContainerProperties.InsertListMember 方法
將單一圖形或一組圖形新增至容器內的清單。
語法
運算式。InsertListMember (ObjectToInsert， Position)
表達 代表 ContainerProperties 物件的 變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| ObjectToInsert | 必要 | [UNKNOWN] | 要插入至清單的物件或選取範圍。 可以是 Shape 或 Selection 物件。 |
| 位置 | 必要 | Long | 插入點在清單中的位置，從 1 起算。 |
傳回值
Nothing
註解
如果容器不是清單，Microsoft Visio 會傳回「無效的來源」錯誤。
如果 ObjectToInsert 參數含括任何的非最上層圖形，或者清單已遭鎖定，則 Visio 將傳回「無效的參數」錯誤。 您不能將下列任何物件插入至清單：
另一個清單。
註標。
可定向連接器。
在 PinX 或 PinY 儲存格套用 BOUND、GUARD 或 SETATREF 函數的圖形。
另一個已鎖定之清單的成員。
Visio 會略過 ObjectToInsert 中原本已是該清單之成員的圖形。
若要插入至清單中的第一個項目之前，請對 Position 參數傳遞 1。 若要插入至清單結尾，則傳遞大於或等於清單項目個數加 1 的 Position 值。 如果傳遞了超出範圍的位置，Visio 便會選擇最接近的有效位置。
如果 ObjectToInsert 不符合清單的類別需求，則 Visio 將傳回錯誤。
類別是由使用者定義的字串，可用來將圖形分類進而限制容器內的成員資格。 您可以在圖形的 ShapeSheet 中從 User.msvShapeCategories 儲存格來定義類別。 若要為圖形定義多個類別，請以分號分隔各類別。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。