WebPartZoneBase.AllowLayoutChange Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá nebo nastaví hodnotu, která označuje, zda lze změnit rozložení ovládacích WebPart prvků v rámci zóny.

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

Hodnota vlastnosti

Boolean

truepokud lze změnit rozložení; v opačném případě . false Výchozí formát je true.

Atributy

ThemeableAttribute

Příklady

Následující příklad kódu ukazuje deklarativní použití AllowLayoutChange vlastnosti WebPartZone ovládacího prvku. Úplný příklad kódu, včetně zdrojového souboru kódu na pozadí a stránky .aspx, která obsahuje zónu v tomto kódu, najdete v přehledu WebPartZoneBase třídy.

Všimněte si, že AllowLayoutChange vlastnost je nastavená na true, což je výchozí hodnota. Pokud hodnotu změníte na false, po načtení stránky do prohlížeče a přepnutí stránky do režimu zobrazení návrhu nebudete moct přetahovat ovládací prvky uvnitř zóny ani do této WebPartZone2 zóny.

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

Poznámky

Vlastnost AllowLayoutChange se projeví pouze v případě, že je zóna v režimu zobrazení stránky, ve kterém lze změnit rozložení ovládacích prvků v zóně, například DesignDisplayMode.

Pokud AllowLayoutChange je pro danou zónu nastavená hodnota na false , existuje několik akcí, které koncoví uživatelé nebudou s ovládacími prvky v zóně provádět:

• Uživatelé nemohou přetahovat ovládací prvky do jiné zóny, měnit uspořádání ovládacích prvků v rámci této zóny ani přesouvat ovládací prvky do zóny.

• Řada vlastností, které ovlivňují uživatelské rozhraní ovládacích WebPart prvků v zóně, je zakázaná, takže uživatelé nemohou tyto vlastnosti upravovat, když se ovládací prvek upravuje pomocí AppearanceEditorPart ovládacích prvků a BehaviorEditorPart .

• Uživatelé nemůžou do zóny přidávat nové ovládací prvky z CatalogPart ovládacího prvku.

• Příkazy zavřít, odstranit, minimalizovat a obnovit se u ovládacích prvků v zóně nezobrazují.

AllowLayoutChange I když vlastnost ovlivňuje schopnost koncových uživatelů změnit rozložení zóny prostřednictvím uživatelského rozhraní, nemá vliv na schopnost měnit rozložení programově. Pokud AllowLayoutChange je například nastavená hodnota false, uživatelé nemůžou zavřít ovládací prvky v zóně, ale vývojář může přesto volat metodu CloseWebPart pro zavření ovládacích prvků programově.

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Viz také

• AllowZoneChange
• ASP.NET ovládací prvky webových částí