WebPartChrome.CreateWebPartChromeStyle(WebPart, PartChromeType) 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

建立樣式物件，該樣式物件為 WebPart 物件呈現的每一個 WebPartChrome 控制項提供樣式屬性。

protected:
 virtual System::Web::UI::WebControls::Style ^ CreateWebPartChromeStyle(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Web::UI::WebControls::WebParts::PartChromeType chromeType);
protected virtual System.Web.UI.WebControls.Style CreateWebPartChromeStyle (System.Web.UI.WebControls.WebParts.WebPart webPart, System.Web.UI.WebControls.WebParts.PartChromeType chromeType);
abstract member CreateWebPartChromeStyle : System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.PartChromeType -> System.Web.UI.WebControls.Style
override this.CreateWebPartChromeStyle : System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.PartChromeType -> System.Web.UI.WebControls.Style
Protected Overridable Function CreateWebPartChromeStyle (webPart As WebPart, chromeType As PartChromeType) As Style

參數

webPart
WebPart

目前正在呈現的控制項。

chromeType
PartChromeType

特定控制項的 Chrome 型別，其中一個 PartChromeType 列舉值。

傳回

Style

Style，包含 webPart 的樣式屬性。

例外狀況

ArgumentNullException

webPart 為 null。

ArgumentOutOfRangeException

chromeType 不是其中一個 PartChromeType 列舉值。

範例

此程式碼範例示範如何使用 CreateWebPartChromeStyle 方法。 如需執行範例所需的完整程式碼，請參閱類別概觀主題的 WebPartChrome 範例一節。

程式碼範例的下一節示範如何覆寫 CreateWebPartChromeStyle 方法。 請注意，它會先擷取基底方法所建立的樣式資訊，然後藉由變更轉譯控制項 WebPart 所使用的字型來修改樣式資訊。

protected override Style CreateWebPartChromeStyle(WebPart part, 
  PartChromeType chromeType)
{
  Style finalStyle = new Style();
  finalStyle.CopyFrom(base.CreateWebPartChromeStyle(part, chromeType));
  finalStyle.Font.Name = "Verdana";
  return finalStyle;
}

Protected Overrides Function CreateWebPartChromeStyle _
  (ByVal part As WebPart, ByVal chromeType As PartChromeType) As Style

  Dim finalStyle As New Style()
  finalStyle.CopyFrom(MyBase.CreateWebPartChromeStyle(Part, chromeType))
  finalStyle.Font.Name = "Verdana"
  Return finalStyle
End Function

如果您在瀏覽器中載入網頁，您可以看到控制項中使用的 WebPart 字型是覆 CreateWebPartChromeStyle 寫方法中指定的字型。

備註

方法 CreateWebPartChromeStyle 會 Style 建立 物件用來 WebPartChrome 呈現 WebPart 控制項的 物件。 預設方法會根據 PartChromeType 參數中所 webPart 參考控制項的 WebPart 屬性值來建立樣式屬性。

選取控制項時 WebPart ，就會發生特殊情況。 如果頁面處於可選取控制項的頁面顯示模式，而且實際上已選取目前的控制項，則預設 CreateWebPartChromeStyle 方法也會合並控制項的樣式資訊與 屬性中的 SelectedPartChromeStyle 樣式資訊。

給繼承者的注意事項

如果您繼承自 WebPartChrome 類別，您可以選擇性地覆寫 CreateWebPartChromeStyle(WebPart, PartChromeType) 方法，並將基底方法中的樣式資訊與您想要新增的自訂樣式屬性合併。 如需示範，請參閱一節中的程式碼。

適用於

另請參閱