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

特定のコントロールのクロムの種類。PartChromeType 列挙値の 1 つ。

戻り値

Style

webPart のスタイル属性を含んでいる Style。

例外

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

ブラウザーで Web ページを読み込む場合、コントロールで WebPart 使用されるフォントがオーバーライド CreateWebPartChromeStyle されたメソッドで指定されているフォントであることがわかります。

注釈

メソッドは CreateWebPartChromeStyle 、 Style オブジェクトがコントロールを WebPartChrome レンダリングするために使用する オブジェクトを WebPart 作成します。 既定のメソッドは、 パラメーターで参照されるコントロールの PartChromeType プロパティ値に WebPart 基づいてスタイル属性を webPart 作成します。

コントロールを選択すると、特別な WebPart 状況が発生します。 ページがコントロールを選択できるページ表示モードにあり、現在のコントロールが実際に選択されている場合、既定 CreateWebPartChromeStyle のメソッドはコントロールのスタイル情報を プロパティの SelectedPartChromeStyle スタイル情報とマージします。

注意 (継承者)

クラスから継承する WebPartChrome 場合は、必要に応じて メソッドを CreateWebPartChromeStyle(WebPart, PartChromeType) オーバーライドし、基本メソッドのスタイル情報を追加するカスタム スタイル属性とマージできます。 デモについては、「例」セクションのコードを参照してください。

こちらもご覧ください

• PartChromeType
• SelectedPartChromeStyle
• ASP.NET Web パーツ コントロール