WebPartZoneBase.CloseVerb Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de fermer les contrôles WebPart contenus dans une zone.
public:
virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CloseVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CloseVerb { get; }[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CloseVerb : System.Web.UI.WebControls.WebParts.WebPartVerbPublic Overridable ReadOnly Property CloseVerb As WebPartVerbValeur de propriété
WebPartVerb qui permet à l'utilisateur final de fermer les contrôles WebPart.
- Attributs
Exemples
L’exemple de code suivant illustre l’utilisation de la CloseVerb propriété sur un WebPartZone contrôle . Pour que l’exemple de code fonctionne, vous avez besoin de tout le code de la section Exemple de la HelpVerb propriété .
La partie suivante de l’exemple de code provient de la classe partielle et contient le code qui bascule si le verbe d’aide est activé ou désactivé.
protected void CheckBoxList1_SelectedItemIndexChanged(Object sender, EventArgs e)
{
foreach (ListItem item in CheckBoxList1.Items)
{
WebPartVerb theVerb;
switch (item.Value)
{
case "close":
theVerb = WebPartZone1.CloseVerb;
break;
case "export":
theVerb = WebPartZone1.ExportVerb;
break;
case "delete":
theVerb = WebPartZone1.DeleteVerb;
break;
case "minimize":
theVerb = WebPartZone1.MinimizeVerb;
break;
case "restore":
theVerb = WebPartZone1.RestoreVerb;
break;
default:
theVerb = null;
break;
}
if (item.Selected)
theVerb.Enabled = true;
else
theVerb.Enabled = false;
}
}
Protected Sub CheckBoxList1_SelectedItemIndexChanged(ByVal sender As [Object], ByVal e As EventArgs)
Dim item As ListItem
For Each item In CheckBoxList1.Items
Dim theVerb As WebPartVerb
Select Case item.Value
Case "close"
theVerb = WebPartZone1.CloseVerb
Case "export"
theVerb = WebPartZone1.ExportVerb
Case "delete"
theVerb = WebPartZone1.DeleteVerb
Case "minimize"
theVerb = WebPartZone1.MinimizeVerb
Case "restore"
theVerb = WebPartZone1.RestoreVerb
Case Else
theVerb = Nothing
End Select
If item.Selected Then
theVerb.Enabled = True
Else
theVerb.Enabled = False
End If
Next item
End Sub
L’autre partie de l’exemple de code est la page Web qui héberge le contrôle personnalisé et contient l’interface utilisateur. Notez que l’élément déclaratif <CloseVerb> dans la zone définit le texte spécifique qui représente le verbe de fermeture dans le menu des verbes du WebPart contrôle.
<asp:WebPartZone ID="WebPartZone1" Runat="server">
<CloseVerb Text="Close WebPart" />
<HelpVerb Text="View Help" />
<ExportVerb Text="Export WebPart Definition" />
<DeleteVerb Text ="Delete WebPart" />
<MinimizeVerb Description="Minimize the control" />
<RestoreVerb Description="Restore the control" />
<ZoneTemplate>
</ZoneTemplate>
</asp:WebPartZone>
<asp:WebPartZone ID="WebPartZone1" Runat="server">
<CloseVerb Text="Close WebPart" />
<HelpVerb Text="View Help" />
<ExportVerb Text="Export WebPart Definition" />
<DeleteVerb Text ="Delete WebPart" />
<MinimizeVerb Description="Minimize the control" />
<RestoreVerb Description="Restore the control" />
<ZoneTemplate>
</ZoneTemplate>
</asp:WebPartZone>
Notez également que, étant donné que le contrôle personnalisé WebPart sous-jacent,nommé TextDisplayWebPart- utilisé dans l’exemple de code définit la AllowClose propriété false sur dans son constructeur, l’élément <aspSample:TextDisplayPart> dans le catalogue doit affecter à truela propriété la AllowClose valeur , afin que le contrôle puisse être fermé dans l’exemple de code suivant.
<asp:CatalogZone ID="CatalogZone1" Runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"
Runat="server">
<WebPartsTemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
AllowClose="true"
ExportMode="All"
HelpMode="Modal"
HelpUrl="TextWebPartHelp.htm" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
<asp:CatalogZone ID="CatalogZone1" Runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"
Runat="server">
<WebPartsTemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
AllowClose="true"
ExportMode="All"
HelpMode="Modal"
HelpUrl="TextWebPartHelp.htm" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
Après avoir chargé la page dans un navigateur, basculez la page en mode d’affichage catalogue et ajoutez le TextDisplayWebPart contrôle à la page. Vous pouvez utiliser les cases à cocher pour activer et désactiver le verbe de fermeture, et vous pouvez cliquer sur le verbe Fermer webPart dans le menu verbes pour fermer le contrôle. Après avoir fermé le contrôle, si vous retournez la page en mode d’affichage catalogue, vous pouvez cliquer sur le catalogue de pages, sélectionner l’instance d’origine du TextDisplayWebPart contrôle que vous avez fermé et la rouvrir sur la page.
Remarques
Le verbe de fermeture référencé par la CloseVerb propriété apparaît dans le menu verbes de chaque WebPart contrôle d’une zone.
La fermeture d’un contrôle le supprime de l’interaction sur une page, bien que si les développeurs fournissent l’interface utilisateur appropriée, telle qu’une CatalogZone zone qui contient un PageCatalogPart contrôle, un utilisateur peut basculer la page dans CatalogDisplayMode et ajouter une instance précédemment fermée d’un contrôle à la page.
