WebPartZoneBase.AllowLayoutChange Propiedad

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í.

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 de .aspx que contiene la zona de este código, consulte la información general de la WebPartZoneBase clase.

Observe que la AllowLayoutChange propiedad se establece trueen , 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 hacia 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 una serie de 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 ni 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 el control se está editando 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 propiedad afecta a la AllowLayoutChange 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, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Compartir vía