WebPartZoneBase.AllowLayoutChange 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出區域中 WebPart 控制項的配置是否可以變更。
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
屬性值
如果配置可以變更,則為 true
,否則為 false
。 預設為 true
。
- 屬性
範例
下列程式代碼範例示範 控件上 WebPartZone 屬性的AllowLayoutChange宣告式用法。 如需完整的程式代碼範例,包括程式代碼後置原始程序檔和包含此程式代碼中區域的 .aspx 頁面,請參閱 WebPartZoneBase 類別概觀。
請注意, AllowLayoutChange 屬性設定 true
為 ,這是預設值。 如果您將值變更為 false
,當您將頁面載入瀏覽器,並將頁面切換為 WebPartZone2
設計顯示模式之後,您將無法在或區域中拖曳控件。
<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>
備註
AllowLayoutChange只有當區域處於頁面顯示模式時,才能變更區域中控件的配置,例如 DesignDisplayMode。
當 指定區域設定為 false
時AllowLayoutChange,有一些使用者無法對區域中的控制項執行動作:
用戶無法將控件拖曳至不同的區域、重新排列區域內的控件,或將控件移到區域中。
已停用許多會影響使用者介面的屬性, (UI) WebPart 區域中的控件,讓使用者在使用 和 BehaviorEditorPart 控件編輯控件時無法編輯AppearanceEditorPart這些屬性。
用戶無法從 CatalogPart 控制項將新的控制項新增至區域。
區域控制件上不會顯示關閉、刪除、最小化和還原動詞。
AllowLayoutChange雖然 屬性會影響使用者透過UI變更區域配置的能力,但不會影響以程式設計方式變更版面配置的能力。 例如,如果 AllowLayoutChange 設定為 false
,則使用者無法關閉區域中的控制件,但開發人員仍然可以呼叫 CloseWebPart 方法來以程式設計方式關閉控制件。
這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊,請參閱 ThemeableAttribute 和 ASP.NET 主題和外觀。