WebPartZoneBase.AllowLayoutChange Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Recebe ou define um valor que indica se a disposição dos WebPart controlos pode ser alterada dentro de uma 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 Propriedade

Boolean

true se o layout puder ser alterado; caso contrário, false. A predefinição é true.

Atributos
ThemeableAttribute

Exemplos

O seguinte exemplo de código demonstra o uso declarativo da AllowLayoutChange propriedade num WebPartZone controlo. Para o exemplo completo do código, incluindo o ficheiro-fonte code-behind e a página .aspx que contém a zona neste código, veja a visão geral da WebPartZoneBase classe.

Note que a AllowLayoutChange propriedade está definida para true, que é o padrão. Se mudares o valor para false, depois de carregares a página num browser e a colocares em modo de visualização de design, não conseguirás arrastar os controlos dentro ou dentro da 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>

Observações

A AllowLayoutChange propriedade só entra em vigor quando uma zona está num modo de apresentação de página em que o layout dos controlos na zona pode ser alterado, como DesignDisplayMode.

Quando AllowLayoutChange está definido para false numa determinada zona, existem várias ações que os utilizadores finais são impedidos de realizar nos controlos dentro da zona:

  • Os utilizadores não podem arrastar os controlos para uma zona diferente, reorganizar os controlos dentro da zona ou mover os controlos para dentro da zona.

  • Várias propriedades que afetam a interface de utilizador (UI) dos WebPart controlos na zona estão desativadas para que os utilizadores não possam editar essas propriedades enquanto o controlo está a ser editado usando os AppearanceEditorPart controlos and BehaviorEditorPart .

  • Os utilizadores não podem adicionar novos controlos à zona a partir de um CatalogPart controlo.

  • Os verbos de fechar, eliminar, minimizar e restaurar não são mostrados nos controlos da zona.

Embora a AllowLayoutChange propriedade afete a capacidade dos utilizadores finais de alterar o layout de uma zona através da interface, não afeta a capacidade de alterar o layout programaticamente. Por exemplo, se AllowLayoutChange for definido para false, os utilizadores não podem fechar os controlos na zona, mas um programador ainda pode chamar o CloseWebPart método para fechar os controlos programaticamente.

Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.

Aplica-se a

Ver também