WebPartChrome.CreateWebPartChromeStyle(WebPart, PartChromeType) Méthode

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée l'objet de style qui fournit des attributs de style pour chaque contrôle WebPart restitué par l'objet 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

Paramètres

webPart: WebPart

Contrôle actuellement en cours de présentation.

chromeType: PartChromeType

Type de chrome pour un contrôle particulier ; une des valeurs de l'énumération PartChromeType.

Retours

Style

Style qui contient les attributs de style pour le webPart.

Exceptions

ArgumentNullException

webPart a la valeur null.

ArgumentOutOfRangeException

chromeType ne fait pas partie des valeurs d'énumération PartChromeType.

Exemples

Cet exemple de code illustre l’utilisation de la CreateWebPartChromeStyle méthode. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la rubrique Vue d’ensemble de la WebPartChrome classe.

La section suivante de l’exemple de code montre comment remplacer la CreateWebPartChromeStyle méthode. Notez qu’il récupère d’abord les informations de style créées par la méthode de base, puis modifie les informations de style en modifiant la police utilisée pour le WebPart contrôle en cours de rendu.

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

Si vous chargez la page Web dans un navigateur, vous pouvez voir que la police utilisée dans les WebPart contrôles est celle spécifiée dans la méthode remplacée CreateWebPartChromeStyle .

Remarques

La CreateWebPartChromeStyle méthode crée un Style objet qui est utilisé par l’objet WebPartChrome pour restituer un WebPart contrôle. La méthode par défaut crée des attributs de style en fonction de la PartChromeType valeur de propriété du WebPart contrôle référencé dans le webPart paramètre.

Une situation spéciale se produit lorsqu’un WebPart contrôle est sélectionné. Si la page est en mode d’affichage de page où les contrôles peuvent être sélectionnés et que le contrôle actuel est réellement sélectionné, la méthode par défaut CreateWebPartChromeStyle fusionne également les informations de style du contrôle avec les informations de style de la SelectedPartChromeStyle propriété.

Notes pour les héritiers

Si vous héritez de la WebPartChrome classe, vous pouvez éventuellement remplacer la CreateWebPartChromeStyle(WebPart, PartChromeType) méthode et fusionner les informations de style de la méthode de base avec les attributs de style personnalisés que vous souhaitez ajouter. Pour une démonstration, consultez le code dans la section Exemple.

S’applique à

Partager via