WebPartChrome.CreateWebPartChromeStyle(WebPart, PartChromeType) Método

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls.WebParts

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea el objeto de estilo que proporciona los atributos de estilo a cada control WebPart procesado por el objeto 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

Parámetros

webPart: WebPart

Control que se está procesando en la actualidad.

chromeType: PartChromeType

El tipo de cromo de un control determinado; uno de los valores de la enumeración PartChromeType.

Devoluciones

Style

Un objeto Style que contiene atributos de estilo para el control webPart.

Excepciones

ArgumentNullException

webPart es null.

ArgumentOutOfRangeException

chromeType no es ninguno de los valores de la enumeración PartChromeType.

Ejemplos

En este ejemplo de código se muestra el uso del CreateWebPartChromeStyle método . Para obtener el código completo necesario para ejecutar el ejemplo, vea la sección Ejemplo del tema de información general de la WebPartChrome clase.

En la sección siguiente del ejemplo de código se muestra cómo invalidar el CreateWebPartChromeStyle método . Observe que primero recupera la información de estilo creada por el método base y, a continuación, modifica la información de estilo cambiando la fuente usada para el WebPart control que se representa.

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 carga la página web en un explorador, puede ver que la fuente usada en los WebPart controles es la especificada en el método invalidado CreateWebPartChromeStyle .

Comentarios

El CreateWebPartChromeStyle método crea un Style objeto utilizado por el WebPartChrome objeto para representar un WebPart control. El método predeterminado crea atributos de estilo basados en el PartChromeType valor de propiedad del WebPart control al que se hace referencia en el webPart parámetro .

Una situación especial se produce cuando se selecciona un WebPart control. Si la página está en modo de presentación de página donde se pueden seleccionar los controles y el control actual está seleccionado, el método predeterminado CreateWebPartChromeStyle también combina la información de estilo del control con la información de estilo de la SelectedPartChromeStyle propiedad .

Notas a los desarrolladores de herederos

Si hereda de la WebPartChrome clase , opcionalmente puede invalidar el CreateWebPartChromeStyle(WebPart, PartChromeType) método y combinar la información de estilo del método base con atributos de estilo personalizados que desea agregar. Para obtener una demostración, consulte el código de la sección Ejemplo.

Se aplica a

Compartir vía