This topic has not yet been rated - Rate this topic

PanelStyle Class

Represents the style for a Panel control.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Web.UI.WebControls.Style
        System.Web.UI.WebControls.PanelStyle

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
public class PanelStyle : Style

The PanelStyle type exposes the following members.

  Name Description
Public method PanelStyle Initializes a new instance of the PanelStyle class.
Top
  Name Description
Public property BackColor Gets or sets the background color of the Web server control. (Inherited from Style.)
Public property BackImageUrl Gets or sets the URL of the background image for the panel control.
Public property BorderColor Gets or sets the border color of the Web server control. (Inherited from Style.)
Public property BorderStyle Gets or sets the border style of the Web server control. (Inherited from Style.)
Public property BorderWidth Gets or sets the border width of the Web server control. (Inherited from Style.)
Protected property CanRaiseEvents Gets a value indicating whether the component can raise an event. (Inherited from Component.)
Public property Container Gets the IContainer that contains the Component. (Inherited from Component.)
Public property CssClass Gets or sets the cascading style sheet (CSS) class rendered by the Web server control on the client. (Inherited from Style.)
Protected property DesignMode Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Public property Direction Gets or sets the direction in which to display controls that include text in a panel control.
Protected property Events Gets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public property Font Gets the font properties associated with the Web server control. (Inherited from Style.)
Public property ForeColor Gets or sets the foreground color (typically the color of the text) of the Web server control. (Inherited from Style.)
Public property Height Gets or sets the height of the Web server control. (Inherited from Style.)
Public property HorizontalAlign Gets or sets the horizontal alignment of the contents within a panel control.
Public property IsEmpty Infrastructure. A protected property. Gets a value indicating whether any style elements have been defined in the state bag. (Inherited from Style.)
Protected property IsTrackingViewState Returns a value indicating whether any style elements have been defined in the state bag. (Inherited from Style.)
Public property RegisteredCssClass Gets the cascading style sheet (CSS) class that is registered with the control. (Inherited from Style.)
Public property ScrollBars Gets or sets the visibility and position of scroll bars in a panel control.
Public property Site Gets or sets the ISite of the Component. (Inherited from Component.)
Protected property ViewState Infrastructure. Gets the state bag that holds the style elements. (Inherited from Style.)
Public property Width Gets or sets the width of the Web server control. (Inherited from Style.)
Public property Wrap Gets or sets a value indicating whether the content wraps within the panel.
Top
  Name Description
Public method AddAttributesToRender(HtmlTextWriter) Adds HTML attributes and styles that need to be rendered to the specified System.Web.UI.HtmlTextWriter. This method is primarily used by control developers. (Inherited from Style.)
Public method AddAttributesToRender(HtmlTextWriter, WebControl) Adds HTML attributes and styles that need to be rendered to the specified System.Web.UI.HtmlTextWriter and Web server control. This method is primarily used by control developers. (Inherited from Style.)
Public method CopyFrom Duplicates the style properties of the specified Style object for the current instance of the PanelStyle class. (Overrides Style.CopyFrom(Style).)
Public method CreateObjRef Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Public method Dispose() Releases all resources used by the Component. (Inherited from Component.)
Protected method Dispose(Boolean) Releases the unmanaged resources used by the Component and optionally releases the managed resources. (Inherited from Component.)
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method FillStyleAttributes Adds the specified object's style properties to a System.Web.UI.CssStyleCollection object. (Inherited from Style.)
Protected method Finalize Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetLifetimeService Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected method GetService Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Public method GetStyleAttributes Retrieves the System.Web.UI.CssStyleCollection object for the specified System.Web.UI.IUrlResolutionService-implemented object. (Inherited from Style.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method InitializeLifetimeService Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected method LoadViewState Loads the previously saved state. (Inherited from Style.)
Protected method MemberwiseClone() Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method MemberwiseClone(Boolean) Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Public method MergeWith Combines the style settings of the specified Style object with the current instance of the PanelStyle class. (Overrides Style.MergeWith(Style).)
Public method Reset Removes any defined style settings from the PanelStyle class. (Overrides Style.Reset().)
Protected method SaveViewState A protected method. Saves any state that has been modified after the TrackViewState method was invoked. (Inherited from Style.)
Protected method SetBit Infrastructure. A protected internal method. Sets an internal bitmask field that indicates the style properties that are stored in the state bag. (Inherited from Style.)
Public method SetDirty Marks the Style so that its state will be recorded in view state. (Inherited from Style.)
Public method ToString Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)
Protected method TrackViewState A protected method. Marks the beginning for tracking state changes on the control. Any changes made after tracking has begun will be tracked and saved as part of the control view state. (Inherited from Style.)
Top
  Name Description
Public event Disposed Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Top
  Name Description
Explicit interface implemetation Private property IStateManager.IsTrackingViewState Gets a value that indicates whether a server control is tracking its view state changes. (Inherited from Style.)
Explicit interface implemetation Private method IStateManager.LoadViewState Infrastructure. Loads the previously saved state. (Inherited from Style.)
Explicit interface implemetation Private method IStateManager.SaveViewState Infrastructure. Returns the object containing state changes. (Inherited from Style.)
Explicit interface implemetation Private method IStateManager.TrackViewState Infrastructure. Starts tracking state changes. (Inherited from Style.)
Top

The PanelStyle class is used to represent the style settings for a panel control. It encapsulates the properties that control the appearance of a panel and can be applied to multiple panel controls to provide a common appearance.

You can specify an image to display in the background of the panel by setting the BackImageUrl property. The horizontal alignment of the contents of the panel is indicated by the HorizontalAlign property. The direction of controls that contain text within the panel control can be specified by setting the Direction property.

The following code example demonstrates creating a PanelStyle object and setting its properties. This example has two parts:

A partial class, PanelStylecs_aspx, that demonstrates creating a new PanelStyle object and setting its properties.

A Web Forms page that uses the PanelStylecs_aspx example as its code-behind file.

The first part of the example demonstrates creating a PanelStyle object, myPanelStyle, and setting its properties. Then the ApplyStyle method is called for both the Panel1 panel and the Panel2 panel, and myPanelStyle is applied to both of them.


public partial class PanelStylecs_aspx : Page
{
    void Page_Load(object sender, EventArgs e)
    {
        StateBag panelState = new StateBag();
        PanelStyle myPanelStyle = new PanelStyle(panelState);

        // Set the properties of the PanelStyle class.
        myPanelStyle.HorizontalAlign = HorizontalAlign.Center;
        myPanelStyle.ScrollBars = ScrollBars.Both;
        myPanelStyle.Wrap = false;
        myPanelStyle.Direction = ContentDirection.LeftToRight;
        myPanelStyle.BackImageUrl = @"~\images\picture.jpg";

        // Use the ApplyStyle method of the Panel control to apply
        // the settings from the myPanelStyle object.
        Panel1.ApplyStyle(myPanelStyle);
        Panel2.ApplyStyle(myPanelStyle); 
    }
}


The second part of the example shows an .aspx file that is used with the previous example.


<%@ Page Language="C#" CodeFile="PanelStyle.cs" Inherits="PanelStylecs_aspx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>PanelStyle Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <h3>PanelStyle Example</h3>
      <asp:Panel id="Panel1" 
        runat="server" 
        width="150" 
        height="50">
        This is the Panel1 panel control.
      </asp:Panel>
      <br /><br />
      <asp:Panel id="Panel2" 
        runat="server" 
        width="150" 
        height="50">
        This is the Panel2 panel control.
      </asp:Panel>
    </form>
  </body>
</html>


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ