WebPartZoneBase.AllowLayoutChange Propriedade

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtém ou define um valor que indica se o layout dos controles WebPart pode ser alterado 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 da propriedade

Boolean

true se o layout puder ser alterado; caso contrário, false. O padrão é true.

Atributos

ThemeableAttribute

Exemplos

O exemplo de código a seguir demonstra o uso declarativo da AllowLayoutChange propriedade em um WebPartZone controle . Para obter o exemplo de código completo, incluindo o arquivo de origem code-behind e a página .aspx que contém a zona nesse código, consulte a visão geral da WebPartZoneBase classe.

Observe que a AllowLayoutChange propriedade é definida como true, que é o padrão. Se você alterar o valor para false, depois de carregar a página em um navegador e alternar a página para o modo de exibição de design, não será possível arrastar controles dentro ou para 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>

Comentários

A AllowLayoutChange propriedade entra em vigor somente quando uma zona está em um modo de exibição de página no qual o layout dos controles na zona pode ser alterado, como DesignDisplayMode.

Quando AllowLayoutChange é definido false como em uma determinada zona, há várias ações que os usuários finais são impedidos de realizar em controles na zona:

• Os usuários não podem arrastar controles para uma zona diferente, reorganizar controles dentro da zona ou mover controles para a zona.

• Várias propriedades que afetam a interface do usuário dos controles na zona são desabilitadas WebPart para que os usuários não possam editar essas propriedades enquanto o controle estiver sendo editado usando os AppearanceEditorPart controles e BehaviorEditorPart .

• Os usuários não podem adicionar novos controles à zona de um CatalogPart controle .

• Os verbos close, delete, minimize e restore não são mostrados nos controles na zona.

Embora a AllowLayoutChange propriedade afete a capacidade dos usuários finais de alterar o layout de uma zona por meio da interface do usuário, ela não afeta a capacidade de alterar o layout programaticamente. Por exemplo, se AllowLayoutChange for definido falsecomo , os usuários não poderão fechar controles na zona, mas um desenvolvedor ainda poderá chamar o CloseWebPart método para fechar os controles programaticamente.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Capas.

Confira também

• AllowZoneChange
• Controles de Web Parts do ASP.NET