DesignerActionService 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
建立管理元件之 DesignerActionItem 物件集合的設計階段服務。
public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
interface IDisposable
Public Class DesignerActionService
Implements IDisposable
- 繼承
-
DesignerActionService
- 衍生
- 實作
備註
類別 DesignerActionService 負責管理元件在設計時間存在於表單上之每個實例的物件集合 DesignerActionItem 。 這個類別會啟用專案建立的直接推送模型,主要是供設計時間工具開發人員使用,雖然元件和自定義控件開發人員也可以使用它。
設計時間工具開發人員必須決定要針對元件顯示的專案清單,並判斷此列表何時變更。 它們也可以建立與智慧標記面板物件搭配運作的載入宏。
進階元件開發人員可能需要動態控制與元件相關聯的專案,因此取代或補充標準提取模型。 例如,視面板命令的使用內容和元件的設計時間狀態而定,可以改變面板命令。
注意
DesignerActionService實際上是推送和提取模型背後的驅動服務;不過,在後者的情況下,它會隱含運作。
DesignerActionService 提供簡單的介面,可讓您存取及操作每個元件的專案,包括下列方法和事件:
方法 Contains 會判斷 目前是否 DesignerActionService 正在管理特定元件。
方法 GetComponentActions 支援專案清單的列舉。
方法Add允許將 或 DesignerActionListCollection 新增DesignerActionList至元件實例的現有專案集。 相反地, Remove 方法會移除與元件相關聯的一或所有項目清單。
注意
方法 Add 代表將面板專案與元件產生關聯之直接推送模型。 相反地,提取模型依賴覆 ActionLists 寫該元件之設計工具類別的屬性。 設計環境負責在設計介面上建立元件時,將這些專案新增至目前的 DesignerActionService 。
事件 DesignerActionListsChanged 會指出元件的專案集合何時變更。
因為通常想要在元件的設計時間快捷方式功能表及其面板中使用一些相同的面板專案,所以對象和設計工具動詞之間 DesignerActionItem 存在大量的互操作性。
如果元件設計工具未明確指定 DesignerActionList (,它不包含覆 ActionLists 寫的屬性) ,則會從現有的設計工具動詞命令建立清單。 這些動詞是由 屬性所指定 Verbs 。 在此情況下,會使用內部動詞清單類別來包含動詞專案面板專案的集合。
如果您想要 DesignerActionMethodItem 同時使用 做為面板專案和設計時間快捷方式功能表項,您可以在專案的建構函式中設定 includeAsDesignerVerb
參數。
DesignerActionUIService使用 來控制設計工具 的ActionLists顯示。
建構函式
DesignerActionService(IServiceProvider) |
初始化 DesignerActionService 類別的新執行個體。 |
方法
事件
DesignerActionListsChanged |
發生於移除或加入任何元件的 DesignerActionList 時。 |