WebPartZoneBase.AllowLayoutChange Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Получает или задает значение, которое указывает, может ли макет элементов управления 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

Значение свойства

Boolean

Значение true, если макет может быть изменен; в противном случае — false. Значение по умолчанию — true.

Атрибуты
ThemeableAttribute

Примеры

В следующем примере кода демонстрируется декларативное AllowLayoutChange использование свойства в элементе WebPartZone управления . Полный пример кода, включая исходный файл программной части и страницу .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.

Если AllowLayoutChange для заданной зоны задано значение false , существует ряд действий, которые конечные пользователи не могут выполнять с элементами управления в зоне.

  • Пользователи не могут перетаскивать элементы управления в другую зону, изменять порядок элементов управления в пределах зоны или перемещать элементы управления в зону.

  • Ряд свойств, влияющих на пользовательский интерфейс WebPart элементов управления в зоне, отключен, поэтому пользователи не могут изменять эти свойства во время редактирования элемента управления с помощью AppearanceEditorPart элементов управления и BehaviorEditorPart .

  • Пользователи не могут добавлять новые элементы управления в зону из CatalogPart элемента управления.

  • Команды закрытия, удаления, свертывание и восстановления не отображаются в элементах управления в зоне.

AllowLayoutChange Хотя свойство влияет на способность конечных пользователей изменять макет зоны с помощью пользовательского интерфейса, оно не влияет на возможность программного изменения макета. Например, если AllowLayoutChange задано значение false, пользователи не могут закрывать элементы управления в зоне, но разработчик может по-прежнему CloseWebPart вызывать метод для программного закрытия элементов управления.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.

Применяется к

См. также раздел