369 lines
12 KiB
C#
369 lines
12 KiB
C#
|
|
//------------------------------------------------------------------------------
|
|
// <copyright file="Panel.cs" company="Microsoft">
|
|
// Copyright (c) Microsoft Corporation. All rights reserved.
|
|
// </copyright>
|
|
//------------------------------------------------------------------------------
|
|
|
|
namespace System.Web.UI.WebControls {
|
|
|
|
using System;
|
|
using System.ComponentModel;
|
|
using System.Drawing.Design;
|
|
using System.Web;
|
|
using System.Web.UI;
|
|
using System.Web.Util;
|
|
|
|
/// <devdoc>
|
|
/// <para>Constructs a panel for specifies layout regions
|
|
/// on a page and defines its properties.</para>
|
|
/// </devdoc>
|
|
[
|
|
Designer("System.Web.UI.Design.WebControls.PanelContainerDesigner, " + AssemblyRef.SystemDesign),
|
|
ParseChildren(false),
|
|
PersistChildren(true),
|
|
]
|
|
public class Panel : WebControl {
|
|
private string _defaultButton;
|
|
private bool _renderedFieldSet = false;
|
|
|
|
|
|
/// <devdoc>
|
|
/// Initializes a new instance of the <see cref='System.Web.UI.WebControls.Panel'/> class.
|
|
/// </devdoc>
|
|
public Panel()
|
|
: base(HtmlTextWriterTag.Div) {
|
|
}
|
|
|
|
|
|
/// <devdoc>
|
|
/// <para>Gets or sets the URL of the background image for the panel control.</para>
|
|
/// </devdoc>
|
|
[
|
|
WebCategory("Appearance"),
|
|
DefaultValue(""),
|
|
Editor("System.Web.UI.Design.ImageUrlEditor, " + AssemblyRef.SystemDesign, typeof(UITypeEditor)),
|
|
UrlProperty(),
|
|
WebSysDescription(SR.Panel_BackImageUrl)
|
|
]
|
|
public virtual string BackImageUrl {
|
|
get {
|
|
if (ControlStyleCreated == false) {
|
|
return String.Empty;
|
|
}
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
return panelStyle.BackImageUrl;
|
|
}
|
|
string s = (string)ViewState["BackImageUrl"];
|
|
return((s == null) ? String.Empty : s);
|
|
}
|
|
set {
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
panelStyle.BackImageUrl = value;
|
|
}
|
|
else {
|
|
ViewState["BackImageUrl"] = value;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/// <devdoc>
|
|
/// Gets or sets default button for the panel
|
|
/// </devdoc>
|
|
[
|
|
DefaultValue(""),
|
|
Themeable(false),
|
|
WebCategory("Behavior"),
|
|
WebSysDescription(SR.Panel_DefaultButton)
|
|
]
|
|
public virtual string DefaultButton {
|
|
get {
|
|
if (_defaultButton == null) {
|
|
return String.Empty;
|
|
}
|
|
return _defaultButton;
|
|
}
|
|
set {
|
|
_defaultButton = value;
|
|
}
|
|
}
|
|
|
|
/// <devdoc>
|
|
/// <para>Gets or sets the direction of text in the panel</para>
|
|
/// </devdoc>
|
|
[
|
|
DefaultValue(ContentDirection.NotSet),
|
|
WebCategory("Layout"),
|
|
WebSysDescription(SR.Panel_Direction)
|
|
]
|
|
public virtual ContentDirection Direction {
|
|
get {
|
|
if (ControlStyleCreated == false) {
|
|
return ContentDirection.NotSet;
|
|
}
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
return panelStyle.Direction;
|
|
}
|
|
object direction = ViewState["Direction"];
|
|
return direction == null ? ContentDirection.NotSet : (ContentDirection) direction;
|
|
}
|
|
set {
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
panelStyle.Direction = value;
|
|
}
|
|
else {
|
|
ViewState["Direction"] = value;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
[
|
|
Localizable(true),
|
|
DefaultValue(""),
|
|
WebCategory("Appearance"),
|
|
WebSysDescription(SR.Panel_GroupingText)
|
|
]
|
|
public virtual string GroupingText {
|
|
get {
|
|
string s = (string)ViewState["GroupingText"];
|
|
return (s != null) ? s : String.Empty;
|
|
}
|
|
set {
|
|
ViewState["GroupingText"] = value;
|
|
}
|
|
}
|
|
|
|
|
|
/// <devdoc>
|
|
/// <para>Gets or sets the horizontal alignment of the contents within the panel.</para>
|
|
/// </devdoc>
|
|
[
|
|
WebCategory("Layout"),
|
|
DefaultValue(HorizontalAlign.NotSet),
|
|
WebSysDescription(SR.Panel_HorizontalAlign)
|
|
]
|
|
public virtual HorizontalAlign HorizontalAlign {
|
|
get {
|
|
if (ControlStyleCreated == false) {
|
|
return HorizontalAlign.NotSet;
|
|
}
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
return panelStyle.HorizontalAlign;
|
|
}
|
|
object o = ViewState["HorizontalAlign"];
|
|
return ((o == null) ? HorizontalAlign.NotSet : (HorizontalAlign)o);
|
|
}
|
|
set {
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
panelStyle.HorizontalAlign = value;
|
|
}
|
|
else {
|
|
if (value < HorizontalAlign.NotSet || value > HorizontalAlign.Justify) {
|
|
throw new ArgumentOutOfRangeException("value");
|
|
}
|
|
ViewState["HorizontalAlign"] = value;
|
|
}
|
|
}
|
|
}
|
|
|
|
public override bool SupportsDisabledAttribute {
|
|
get {
|
|
return RenderingCompatibility < VersionUtil.Framework40;
|
|
}
|
|
}
|
|
|
|
/// <devdoc>
|
|
/// <para>Gets or sets the scrollbar behavior of the panel.</para>
|
|
/// </devdoc>
|
|
[
|
|
DefaultValue(ScrollBars.None),
|
|
WebCategory("Layout"),
|
|
WebSysDescription(SR.Panel_ScrollBars)
|
|
]
|
|
public virtual ScrollBars ScrollBars {
|
|
get {
|
|
if (ControlStyleCreated == false) {
|
|
return ScrollBars.None;
|
|
}
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
return panelStyle.ScrollBars;
|
|
}
|
|
object scroll = ViewState["ScrollBars"];
|
|
return ((scroll == null) ? ScrollBars.None : (ScrollBars)scroll);
|
|
}
|
|
set {
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
panelStyle.ScrollBars = value;
|
|
}
|
|
else {
|
|
ViewState["ScrollBars"] = value;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/// <devdoc>
|
|
/// <para>Gets or sets a value
|
|
/// indicating whether the content wraps within the panel.</para>
|
|
/// </devdoc>
|
|
[
|
|
WebCategory("Layout"),
|
|
DefaultValue(true),
|
|
WebSysDescription(SR.Panel_Wrap)
|
|
]
|
|
public virtual bool Wrap {
|
|
get {
|
|
if (ControlStyleCreated == false) {
|
|
return true;
|
|
}
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
return panelStyle.Wrap;
|
|
}
|
|
object b = ViewState["Wrap"];
|
|
return ((b == null) ? true : (bool)b);
|
|
}
|
|
set {
|
|
PanelStyle panelStyle = ControlStyle as PanelStyle;
|
|
if (panelStyle != null) {
|
|
panelStyle.Wrap = value;
|
|
}
|
|
else {
|
|
ViewState["Wrap"] = value;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/// <internalonly/>
|
|
/// <devdoc>
|
|
/// Add background-image to list of style attributes to render.
|
|
/// Add align and nowrap to list of attributes to render.
|
|
/// </devdoc>
|
|
protected override void AddAttributesToRender(HtmlTextWriter writer) {
|
|
base.AddAttributesToRender(writer);
|
|
|
|
string s = BackImageUrl;
|
|
// Whidbey 12856
|
|
if (s.Trim().Length > 0) {
|
|
writer.AddStyleAttribute(HtmlTextWriterStyle.BackgroundImage, "url(" + ResolveClientUrl(s) + ")");
|
|
}
|
|
|
|
AddScrollingAttribute(ScrollBars, writer);
|
|
|
|
HorizontalAlign hAlign = HorizontalAlign;
|
|
if (hAlign != HorizontalAlign.NotSet) {
|
|
TypeConverter hac = TypeDescriptor.GetConverter(typeof(HorizontalAlign));
|
|
writer.AddStyleAttribute(HtmlTextWriterStyle.TextAlign, hac.ConvertToInvariantString(hAlign).ToLowerInvariant());
|
|
}
|
|
|
|
if (!Wrap) {
|
|
if (EnableLegacyRendering) {
|
|
writer.AddAttribute(HtmlTextWriterAttribute.Nowrap, "nowrap", false);
|
|
}
|
|
else {
|
|
writer.AddStyleAttribute(HtmlTextWriterStyle.WhiteSpace, "nowrap");
|
|
}
|
|
}
|
|
|
|
if (Direction == ContentDirection.LeftToRight) {
|
|
writer.AddAttribute(HtmlTextWriterAttribute.Dir, "ltr");
|
|
}
|
|
else if (Direction == ContentDirection.RightToLeft) {
|
|
writer.AddAttribute(HtmlTextWriterAttribute.Dir, "rtl");
|
|
}
|
|
|
|
if (!DesignMode &&
|
|
(Page != null) &&
|
|
(Page.RequestInternal != null) &&
|
|
(Page.Request.Browser.EcmaScriptVersion.Major > 0) &&
|
|
(Page.Request.Browser.W3CDomVersion.Major > 0)) {
|
|
if (DefaultButton.Length > 0) {
|
|
// Find control from the page if it's a hierarchical ID.
|
|
// Dev11 bug 19915
|
|
Control c = FindControlFromPageIfNecessary(DefaultButton);
|
|
|
|
if (c is IButtonControl) {
|
|
Page.ClientScript.RegisterDefaultButtonScript(c, writer, true /* UseAddAttribute */);
|
|
}
|
|
else {
|
|
throw new InvalidOperationException(SR.GetString(SR.HtmlForm_OnlyIButtonControlCanBeDefaultButton, ID));
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/// <devdoc>
|
|
/// [To be supplied.]
|
|
/// </devdoc>
|
|
private void AddScrollingAttribute(ScrollBars scrollBars, HtmlTextWriter writer) {
|
|
switch (scrollBars) {
|
|
case ScrollBars.Horizontal:
|
|
writer.AddStyleAttribute(HtmlTextWriterStyle.OverflowX, "scroll");
|
|
break;
|
|
case ScrollBars.Vertical:
|
|
writer.AddStyleAttribute(HtmlTextWriterStyle.OverflowY, "scroll");
|
|
break;
|
|
case ScrollBars.Both:
|
|
writer.AddStyleAttribute(HtmlTextWriterStyle.Overflow, "scroll");
|
|
break;
|
|
case ScrollBars.Auto:
|
|
writer.AddStyleAttribute(HtmlTextWriterStyle.Overflow, "auto");
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
|
|
|
|
/// <internalonly/>
|
|
/// <devdoc>
|
|
/// <para>A protected method. Creates a panel control style.</para>
|
|
/// </devdoc>
|
|
protected override Style CreateControlStyle() {
|
|
return new PanelStyle(ViewState);
|
|
}
|
|
|
|
|
|
/// <internalonly/>
|
|
public override void RenderBeginTag(HtmlTextWriter writer) {
|
|
AddAttributesToRender(writer);
|
|
|
|
HtmlTextWriterTag tagKey = TagKey;
|
|
if (tagKey != HtmlTextWriterTag.Unknown) {
|
|
writer.RenderBeginTag(tagKey);
|
|
}
|
|
else {
|
|
writer.RenderBeginTag(TagName);
|
|
}
|
|
|
|
string s = GroupingText;
|
|
bool useGrouping = (s.Length != 0) && !(writer is Html32TextWriter);
|
|
if (useGrouping) {
|
|
writer.RenderBeginTag(HtmlTextWriterTag.Fieldset);
|
|
_renderedFieldSet = true;
|
|
writer.RenderBeginTag(HtmlTextWriterTag.Legend);
|
|
writer.Write(s);
|
|
writer.RenderEndTag();
|
|
}
|
|
}
|
|
|
|
public override void RenderEndTag(HtmlTextWriter writer) {
|
|
if (_renderedFieldSet) {
|
|
writer.RenderEndTag();
|
|
}
|
|
base.RenderEndTag(writer);
|
|
}
|
|
}
|
|
}
|