CatalogZoneBase.CloseVerb Propriedade

Definição

Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais fechar a interface de utilizador (UI) do catálogo e devolver a página ao modo normal de navegação.

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.WebPartVerb
Public Overridable ReadOnly Property CloseVerb As WebPartVerb

Valor de Propriedade

Um que permite aos WebPartVerb utilizadores finais fechar a interface do catálogo na página Web.

Atributos

Exemplos

O exemplo de código seguinte demonstra como aceder à CloseVerb propriedade tanto de forma declarativa como programática. Para o código completo necessário para executar o exemplo, consulte a secção Exemplo da CatalogZoneBase visão geral da classe.

A primeira parte do exemplo de código mostra como aceder declarativamente à CloseVerb propriedade numa página Web. Este exemplo personaliza a Description propriedade do verbo.

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />
<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

A segunda parte do exemplo mostra como aceder à CloseVerb propriedade programaticamente, usando um botão de alternância para a ativar ou desativar.

protected void Button1_Click(object sender, EventArgs e)
{
  if (CatalogZone1.AddVerb.Enabled)
  {
    CatalogZone1.AddVerb.Enabled = false;
    CatalogZone1.CloseVerb.Enabled = false;
  }
  else
  {
    CatalogZone1.AddVerb.Enabled = true;
    CatalogZone1.CloseVerb.Enabled = true;
  }
}
Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  If CatalogZone1.AddVerb.Enabled Then
    CatalogZone1.AddVerb.Enabled = False
    CatalogZone1.CloseVerb.Enabled = False
  Else
    CatalogZone1.AddVerb.Enabled = True
    CatalogZone1.CloseVerb.Enabled = True
  End If

End Sub

Quando carregas a página num navegador, podes selecionar Catálogo na lista suspensa para mudar para o modo de visualização do catálogo. Quando o catálogo está visível, ao posicionar o ponteiro do rato sobre o botão Fechar , pode ver o texto da descrição numa dica de ferramenta. Também pode clicar no botão Habilitar ou Desabilitar Verbos para demonstrar que pode aceder ao verbo fechado programaticamente.

Observações

O verbo fechado é referenciado pela CloseVerb propriedade num controlo derivado da CatalogZoneBase classe.

O utilizador pode clicar no verbo fechar no rodapé da zona. Quando o utilizador clica no verbo fechar, quaisquer CatalogPart controlos selecionados são ignorados, a interface do catálogo fecha e a página volta ao modo normal de navegação.

O verbo próximo é um controlo ao nível da zona, o que significa que a sua ação se aplica ao nível de toda a zona. Quando um utilizador clica no verbo de fechar, quaisquer controlos que tenham sido selecionados mas não adicionados à página são ignorados, o catálogo é encerrado e a página volta ao modo de navegação.

Aplica-se a

Ver também