共用方式為


HOW TO:公開組成控制項的屬性

組成複合控制項 (Composite Control) 的控制項稱為組成控制項。 這些控制項通常是宣告為私用的 (Private),因此開發人員無法存取。 如果您希望未來使用者能夠使用這些控制項的屬性,必須將屬性公開給使用者。 若要公開組成控制項的屬性,您可在使用者控制項中建立屬性,並使用這個屬性的 get 和 set 存取子來使組成控制項的私用屬性中的變更生效。

假設某個使用者控制項有一個名為 MyButton 的組成按鈕。 在這個範例中,當使用者要求 ConstituentButtonBackColor 屬性時,就會傳遞儲存在 MyButton 的 BackColor 屬性中的值。 當使用者將值指派給這個屬性時,會將這個值自動傳遞至 MyButton 的 BackColor 屬性,並將執行 set 程式碼,變更 MyButton 的色彩。

下面的範例顯示如何公開組成按鈕的 BackColor 屬性:

Public Property ButtonColor() as System.Drawing.Color
   Get
      Return MyButton.BackColor
   End Get
   Set(Value as System.Drawing.Color)
      MyButton.BackColor = Value
   End Set
End Property
public Color ButtonColor
{
   get
   {
      return(myButton.BackColor);
   }
   set
   {
      myButton.BackColor = value;
   }
}
/** @property */
public Color get_ButtonColor()
{
   return myButton.get_BackColor();
}
/** @property */
public void set_ButtonColor(Color value)
{
   myButton.set_BackColor(value);
}

若要公開組成控制項的屬性

  1. 為使用者控制項建立公用屬性。

  2. 在屬性的 get 區段,寫入可擷取您要公開的屬性值的程式碼。

  3. 在屬性的 set 區段,寫入將屬性值傳遞到組成控制項的公開屬性的程式碼。

請參閱

參考

UserControl

概念

各種自訂控制項

其他資源

Windows Form 控制項中的屬性