ContainerProperties.AddMember 方法 (Visio)

將單一圖形或一組圖形新增至容器。

語法

運算式AddMember (pObjectToAddaddOptions)

運算式 代表 ContainerProperties 物件的變數。

參數

名稱 必要/選用 資料類型 描述
pObjectToAdd 必要 未知 要新增至容器的一個或多個圖形。 可以是 ShapeSelection 類型。
addOptions 必要 VisMemberAddOptions 決定容器是否應該擴展為完全包含所新增的圖形。 必須是 VisMemberAddOptions 常數之一。

傳回值

Nothing

註解

傳遞 visMemberAddUseResizeSettingvisMemberAddDoNotExpand 做為 addOptions 時,可能致使圖形雖為容器成員,實際卻不在容器內。 在這種情況下,容器本身或該成員往後一旦移動或調整大小,圖形可能就會喪失容器成員資格。

如果容器是清單,AddMember 便會將指定的物件新增至清單容器而非清單本身。 換言之,圖形雖由清單所包含,其實並不在清單中。 當容器本身位於清單中時,對於該容器內的圖形而言這種情形頗為常見。

如果 ContainerProperties.LockMembership 屬性為 True,則 Microsoft Visio 會傳回停用的錯誤。

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