WebPartZoneBase.AllowLayoutChange Propiedad

  • Referencia

Definición

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

Obtiene o establece un valor que indica si el diseño de los controles WebPart se puede cambiar dentro de una zona.

public:
 virtual property bool AllowLayoutChange { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool AllowLayoutChange { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.AllowLayoutChange : bool with get, set
Public Overridable Property AllowLayoutChange As Boolean

Valor de propiedad

Boolean

Es true si se puede cambiar el diseño; de lo contrario, es false. De manera predeterminada, es true.

Atributos
ThemeableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso declarativo de la AllowLayoutChange propiedad en un WebPartZone control . Para obtener el ejemplo de código completo, incluido el archivo de código fuente subyacente y la página .aspx que contiene la zona de este código, consulte la información general de la WebPartZoneBase clase.

Observe que la AllowLayoutChange propiedad está establecida en true, que es el valor predeterminado. Si cambia el valor a false, después de cargar la página en un explorador y cambiar la página al modo de presentación de diseño, no podrá arrastrar controles dentro o a la WebPartZone2 zona.

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

Comentarios

La AllowLayoutChange propiedad solo surte efecto cuando una zona está en un modo de presentación de página en el que se puede cambiar el diseño de los controles de la zona, como DesignDisplayMode.

Cuando AllowLayoutChange se establece false en en una zona determinada, hay varias acciones que los usuarios finales no pueden llevar a cabo en los controles de la zona:

  • Los usuarios no pueden arrastrar controles a otra zona, reorganizar controles dentro de la zona o mover controles a la zona.

  • Se deshabilitan varias propiedades que afectan a la interfaz de usuario (UI) de los controles de WebPart la zona para que los usuarios no puedan editar esas propiedades mientras se edita el control mediante los AppearanceEditorPart controles y BehaviorEditorPart .

  • Los usuarios no pueden agregar nuevos controles a la zona desde un CatalogPart control .

  • Los verbos close, delete, minimize y restore no se muestran en los controles de la zona.

Aunque la AllowLayoutChange propiedad afecta a la capacidad de los usuarios finales para cambiar el diseño de una zona a través de la interfaz de usuario, no afecta a la capacidad de cambiar el diseño mediante programación. Por ejemplo, si AllowLayoutChange se establece falseen , los usuarios no pueden cerrar los controles de la zona, pero un desarrollador podría seguir llamando al CloseWebPart método para cerrar los controles mediante programación.

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, consulte ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también