WebPartChrome.CreateWebPartChromeStyle(WebPart, PartChromeType) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt das Stilobjekt, das die Stilattribute für jedes WebPart-Steuerelement bereitstellt, das vom WebPartChrome-Objekt gerendert wird.

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

Parameter

webPart: WebPart

Das Steuerelement, das gerade gerendert wird.

chromeType: PartChromeType

Der Chromtyp für ein bestimmtes Steuerelement; einer der PartChromeType-Enumerationswerte.

Gibt zurück

Style

Ein Style-Objekt, das Stilattribute für das webPart-Steuerelement enthält.

Ausnahmen

ArgumentNullException

webPart ist null.

ArgumentOutOfRangeException

chromeType ist keiner der PartChromeType-Enumerationswerte.

Beispiele

In diesem Codebeispiel wird die Verwendung der CreateWebPartChromeStyle -Methode veranschaulicht. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des WebPartChrome Themas Klassenübersicht.

Im folgenden Abschnitt aus dem Codebeispiel wird veranschaulicht, wie die -Methode überschrieben CreateWebPartChromeStyle wird. Beachten Sie, dass zuerst die von der Basismethode erstellten Formatvorlageninformationen abgerufen und dann die Formatvorlageninformationen geändert werden, indem die schriftart geändert wird, die für das WebPart gerenderte Steuerelement verwendet wird.

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

Wenn Sie die Webseite in einem Browser laden, können Sie sehen, dass die in den WebPart Steuerelementen verwendete Schriftart die schriftart ist, die in der überschriebenen CreateWebPartChromeStyle Methode angegeben ist.

Hinweise

Die CreateWebPartChromeStyle -Methode erstellt ein Style -Objekt, das vom -Objekt zum Rendern WebPartChrome eines Steuerelements WebPart verwendet wird. Die Standardmethode erstellt Stilattribute basierend auf dem PartChromeType Eigenschaftswert des WebPart Steuerelements, auf das webPart im Parameter verwiesen wird.

Eine besondere Situation tritt auf, wenn ein WebPart Steuerelement ausgewählt wird. Wenn sich die Seite in einem Seitenanzeigemodus befindet, in dem Steuerelemente ausgewählt werden können, und das aktuelle Steuerelement tatsächlich ausgewählt ist, führt die Standardmethode CreateWebPartChromeStyle auch die Formatinformationen des Steuerelements mit den Formatvorlageninformationen aus der SelectedPartChromeStyle -Eigenschaft zusammen.

Hinweise für Vererber

Wenn Sie von der WebPartChrome -Klasse erben, können Sie optional die CreateWebPartChromeStyle(WebPart, PartChromeType) -Methode überschreiben und die Formatvorlageninformationen der Basismethode mit benutzerdefinierten Formatattributen zusammenführen, die Sie hinzufügen möchten. Eine Demonstration finden Sie im Code im Abschnitt Beispiel.

Gilt für:

Share via