WebPartZoneBase.CloseVerb Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům zavřít WebPart ovládací prvky v zóně.
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 WebPartVerbHodnota vlastnosti
A WebPartVerb , který umožňuje koncovým uživatelům zavřít WebPart ovládací prvky.
- Atributy
Příklady
Následující příklad kódu ukazuje použití CloseVerb vlastnosti v ovládacím prvku WebPartZone . Aby příklad kódu fungoval, potřebujete veškerý kód z části HelpVerb Example vlastnosti.
Následující část příkladu kódu pochází z částečné třídy a obsahuje kód, který přepíná, zda je příkaz nápovědy povolený nebo zakázaný.
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
Druhou částí příkladu kódu je webová stránka, která je hostitelem vlastního ovládacího prvku a obsahuje uživatelské rozhraní. Všimněte si, že deklarativní <CloseVerb> prvek v zóně nastaví konkrétní text, který představuje příkaz zavřít v nabídce sloves pro WebPart ovládací prvek.
<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>
Všimněte si také, že vzhledem k tomu, že základní vlastní WebPart ovládací prvek s názvem TextDisplayWebPart-- použitý v příkladu kódu nastaví AllowClose vlastnost na false ve svém konstruktoru <aspSample:TextDisplayPart> , musí element v katalogu nastavit AllowClose vlastnost na true, aby bylo možné ovládací prvek zavřít v následujícím příkladu kódu.
<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>
Po načtení stránky v prohlížeči přepněte stránku do režimu zobrazení katalogu a přidejte TextDisplayWebPart na stránku ovládací prvek. Pomocí zaškrtávacích políček můžete povolit nebo zakázat příkaz zavřít a kliknutím na příkaz Zavřít webovou část v nabídce sloves ovládací prvek zavřít. Pokud po zavření ovládacího prvku vrátíte stránku do režimu zobrazení katalogu, můžete kliknout na Katalog stránek, vybrat původní instanci TextDisplayWebPart ovládacího prvku, který jste zavřeli, a znovu ho otevřít na stránce.
Poznámky
Příkaz zavřít, na který CloseVerb odkazuje vlastnost, se zobrazí v nabídce sloves každého WebPart ovládacího prvku v zóně.
Zavřením ovládacího prvku se odebere z interakce na stránce, i když pokud vývojáři zadají příslušné uživatelské rozhraní(UI), například zónu CatalogZone , která obsahuje PageCatalogPart ovládací prvek, může uživatel stránku přepnout na CatalogDisplayMode a přidat na ni dříve uzavřenou instanci ovládacího prvku.
