WebPartZoneBase.CloseVerb Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais fechar os controles WebPart em uma zona.
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 WebPartVerbValor da propriedade
Um WebPartVerb que permite que os usuários finais fechem WebPart controles.
- Atributos
Exemplos
O exemplo de código a seguir demonstra o uso da CloseVerb propriedade em um WebPartZone controle . Para que o exemplo de código funcione, você precisa de todo o código da seção Exemplo da HelpVerb propriedade .
A parte a seguir do exemplo de código é da classe parcial e contém o código que alterna se o verbo de ajuda está habilitado ou desabilitado.
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
A outra parte do exemplo de código é a página da Web que hospeda o controle personalizado e contém a interface do usuário. Observe que o elemento declarativo <CloseVerb> na zona define o texto específico que representa o verbo close no menu de verbos do WebPart controle.
<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>
Observe também que, como o controle personalizado WebPart subjacente , chamado TextDisplayWebPart, usado no exemplo de código define a AllowClose propriedade como false em seu construtor, o <aspSample:TextDisplayPart> elemento no catálogo deve definir a AllowClose propriedade como , para trueque o controle possa ser fechado no exemplo de código a seguir.
<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>
Depois de carregar a página em um navegador, alterne a página para o modo de exibição do catálogo e adicione o TextDisplayWebPart controle à página. Você pode usar as caixas de seleção para habilitar e desabilitar o verbo fechar e clicar no verbo Fechar WebPart no menu de verbos para fechar o controle. Depois de fechar o controle, se você retornar a página para o modo de exibição de catálogo, poderá clicar no Catálogo de Páginas, selecionar a instância original do TextDisplayWebPart controle que você fechou e reabri-la na página.
Comentários
O verbo de fechamento referenciado pela CloseVerb propriedade aparece no menu de verbos de cada WebPart controle em uma zona.
Fechar um controle o remove da interação em uma página, embora se os desenvolvedores fornecerem a interface do usuário apropriada, como uma CatalogZone zona que contém um PageCatalogPart controle, um usuário poderá alternar a página CatalogDisplayMode para e adicionar uma instância anteriormente fechada de um controle de volta à página.
