WebPartZoneBase.CloseVerb Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais fechar os WebPart controlos numa 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 de Propriedade
A que permite aos WebPartVerb utilizadores finais fechar WebPart controlos.
- Atributos
Exemplos
O exemplo de código seguinte demonstra a utilização da CloseVerb propriedade num WebPartZone controlo. Para que o exemplo de código funcione, precisas de todo o código da secção de Exemplo da HelpVerb propriedade.
A parte seguinte do exemplo de código é da classe parcial e contém o código que alterna se o verbo de ajuda está ativado ou desativado.
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 do código é a página Web que aloja o controlo personalizado e contém a interface. Note que o elemento declarativo <CloseVerb> na zona define o texto específico que representa o verbo fechado no menu verbos do WebPart controlo.
<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>
Note também que, como o controlo personalizado WebPart subjacente — chamado TextDisplayWebPart— usado no exemplo de código define a AllowClose propriedade como false no seu construtor, o <aspSample:TextDisplayPart> elemento no catálogo deve definir a AllowClose propriedade para true, de modo que o controlo possa ser fechado no seguinte exemplo de código.
<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 num navegador, mude a página para o modo de exibição de catálogo e adicione o TextDisplayWebPart controlo à página. Podes usar as caixas de seleção para ativar e desativar o verbo fechar, e podes clicar no verbo Fechar WebPart no menu verbos para fechar o controlo. Depois de fechar o controlo, se voltar a colocar a página no modo de visualização de catálogo, pode clicar no Catálogo de Páginas, selecionar a instância original do TextDisplayWebPart controlo que fechou, e reabri-la na página.
Observações
O verbo próximo referenciado pela CloseVerb propriedade aparece no menu de verbos de cada WebPart controlo numa zona.
Fechar um controlo remove-o da interação numa página, embora, se os programadores fornecerem a interface de utilizador (UI) apropriada, como uma CatalogZone zona que contenha um PageCatalogPart controlo, o utilizador possa mudar a página para CatalogDisplayMode dentro e adicionar uma instância previamente fechada de um controlo de volta à página.