Visio) (ContainerProperties.AddMember 方法
將單一圖形或一組圖形新增至容器。
語法
運算式。AddMember (pObjectToAdd, addOptions)
表達 代表 ContainerProperties 物件的 變數。
參數
名稱 | 必要/選用 | 資料類型 | 描述 |
---|---|---|---|
pObjectToAdd | 必要 | 未知 | 要新增至容器的一個或多個圖形。 可以 是 Shape 或Selection類型。 |
addOptions | 必要 | VisMemberAddOptions | 決定容器是否應該擴展為完全包含所新增的圖形。 必須是其中一個 VisMemberAddOptions 常數。 |
傳回值
Nothing
註解
傳遞 visMemberAddUseResizeSetting 或 visMemberAddDoNotExpand 做為 addOptions 時,可能致使圖形雖為容器成員,實際卻不在容器內。 在這種情況下,容器本身或該成員往後一旦移動或調整大小,圖形可能就會喪失容器成員資格。
如果容器是清單,AddMember 便會將指定的物件新增至清單容器而非清單本身。 換言之,圖形雖由清單所包含,其實並不在清單中。 當容器本身位於清單中時,對於該容器內的圖形而言這種情形頗為常見。
如果 ContainerProperties.LockMembership 屬性為 True,Microsoft Visio 會傳回 Disabled 錯誤。
如果 pObjectToAdd 參數並未含括頁面上的最上層圖形,Visio 將傳回「無效的參數」錯誤。
如果您嘗試使用 AddMember 方法,將容器圖形本身或該容器的子圖形新增至容器,Visio 也會傳回「無效的參數」錯誤。
如果 pObjectToAdd 不符合清單或容器的類別需求,Visio 會傳回不正確目標錯誤。 圖形可以被指派類別,而容器則可有必要的類別和排除的類別。
類別是由使用者定義的字串,可用來將圖形分類進而限制容器內的成員資格。 您可以在圖形的 ShapeSheet 中從 User.msvShapeCategories 儲存格來定義類別。 若要為圖形定義多個類別,請以分號分隔各類別。
範例
下列 Visual Basic for Applications (VBA) 範例示範如何使用 AddMember 方法,將 vsoShape () 的新成員新增至頁面上 vsoContainerShape) (現有容器。 程式碼假設 vsoShape 已與 vsoContainerShape 重迭。
vsoContainerShape.ContainerProperties.AddMember vsoShape, visMemberAddExpandContainer
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。