WebPartZoneBase.AllowLayoutChange Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient ou définit une valeur qui indique si la disposition des contrôles WebPart peut être changée dans une zone.

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

Valeur de propriété

Boolean

true si la disposition peut être modifiée ; sinon, false. La valeur par défaut est true.

Attributs

ThemeableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation déclarative de la AllowLayoutChange propriété sur un WebPartZone contrôle. Pour obtenir l’exemple de code complet, y compris le fichier source code-behind et la page .aspx qui contient la zone dans ce code, consultez la vue d’ensemble de la WebPartZoneBase classe.

Notez que la propriété a la AllowLayoutChangetruevaleur , qui est la valeur par défaut. Si vous modifiez la valeur en false, une fois que vous avez chargé la page dans un navigateur et que vous avez basculé la page en mode d’affichage conception, vous ne pourrez pas faire glisser les contrôles à l’intérieur ou dans la WebPartZone2 zone.

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

Remarques

La AllowLayoutChange propriété prend effet uniquement lorsqu’une zone est en mode d’affichage de page dans lequel la disposition des contrôles de la zone peut être modifiée, par DesignDisplayModeexemple .

Lorsque AllowLayoutChange est défini false sur sur une zone donnée, il existe un certain nombre d’actions que les utilisateurs finaux ne peuvent pas effectuer sur les contrôles dans la zone :

• Les utilisateurs ne peuvent pas faire glisser des contrôles vers une autre zone, réorganiser les contrôles dans la zone ou déplacer des contrôles dans la zone.

• Un certain nombre de propriétés qui affectent l’interface utilisateur des contrôles de WebPart la zone sont désactivées afin que les utilisateurs ne puissent pas modifier ces propriétés pendant que le contrôle est modifié à l’aide des AppearanceEditorPart contrôles et BehaviorEditorPart .

• Les utilisateurs ne peuvent pas ajouter de nouveaux contrôles à la zone à partir d’un CatalogPart contrôle.

• Les verbes fermer, supprimer, réduire et restaurer ne s’affichent pas sur les contrôles de la zone.

Bien que la propriété affecte la AllowLayoutChange capacité des utilisateurs finaux à modifier la disposition d’une zone via l’interface utilisateur, elle n’affecte pas la possibilité de modifier la disposition par programmation. Par exemple, si AllowLayoutChange est défini sur false, les utilisateurs ne peuvent pas fermer les contrôles dans la zone, mais un développeur peut toujours appeler la CloseWebPart méthode pour fermer les contrôles par programmation.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et skins.

Voir aussi

• AllowZoneChange
• contrôles de composants WebPart ASP.NET