WebPartZoneBase.CloseVerb Propiedad

Definición

Obtiene una referencia a un objeto WebPartVerb que permite a los usuarios finales cerrar los controles WebPart de una zona.Gets a reference to a WebPartVerb object that enables end users to close the WebPart controls in a 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.WebPartVerb
Public Overridable ReadOnly Property CloseVerb As WebPartVerb

Valor de propiedad

WebPartVerb

WebPartVerb que permite a los usuarios finales cerrar controles WebPart.A WebPartVerb that enables end users to close WebPart controls.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la CloseVerb propiedad en un WebPartZone control.The following code example demonstrates the use of the CloseVerb property on a WebPartZone control. Para que el ejemplo de código funcione, necesita todo el código de la sección de ejemplo de la HelpVerb propiedad.For the code example to work, you need all the code from the Example section of the HelpVerb property.

La siguiente parte del ejemplo de código es de la clase parcial y contiene el código que alterna si el verbo de ayuda está habilitado o deshabilitado.The following part of the code example is from the partial class, and contains the code that toggles whether the help verb is enabled or disabled.

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

La otra parte del ejemplo de código es la página web que hospeda el control personalizado y contiene la interfaz de usuario.The other part of the code example is the Web page that hosts the custom control and contains the UI. Observe que el elemento declarativo <CloseVerb> de la zona establece el texto específico que representa el verbo cerrar en el menú de verbos del WebPart control.Notice that the declarative <CloseVerb> element in the zone sets the specific text that represents the close verb in the verbs menu for the WebPart control.

<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>

Tenga en cuenta también que, dado que el control personalizado subyacente ( WebPart denominado TextDisplayWebPart ) usado en el ejemplo de código establece la AllowClose propiedad en false en su constructor, el <aspSample:TextDisplayPart> elemento del catálogo debe establecer la AllowClose propiedad en true , de modo que el control se pueda cerrar en el ejemplo de código siguiente.Notice also that, because the underlying custom WebPart control--named TextDisplayWebPart-- used in the code example sets the AllowClose property to false in its constructor, the <aspSample:TextDisplayPart> element in the catalog must set the AllowClose property to true, so that the control can be closed in the following code example.

<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>

Después de cargar la página en un explorador, cambie la página al modo de presentación del catálogo y agregue el TextDisplayWebPart control a la página.After you load the page in a browser, switch the page into catalog display mode, and add the TextDisplayWebPart control to the page. Puede usar las casillas para habilitar y deshabilitar el verbo Cerrar, y puede hacer clic en el verbo cerrar elemento Web en el menú de verbos para cerrar el control.You can use the check boxes to enable and disable the close verb, and you can click the Close WebPart verb in the verbs menu to close the control. Después de cerrar el control, si devuelve la página al modo de presentación del catálogo, puede hacer clic en el Catálogo de páginas, seleccionar la instancia original del TextDisplayWebPart control que ha cerrado y volver a abrirla en la página.After you close the control, if you return the page to catalog display mode, you can click the Page Catalog, select the original instance of the TextDisplayWebPart control that you closed, and reopen it on the page.

Comentarios

El verbo cerrar al que hace referencia la CloseVerb propiedad aparece en el menú de verbos de cada WebPart control de una zona.The close verb referenced by the CloseVerb property appears in the verbs menu of each WebPart control in a zone.

Al cerrar un control se quita de la interacción de una página, aunque si los desarrolladores proporcionan la interfaz de usuario (IU) adecuada, como una CatalogZone zona que contiene un PageCatalogPart control, un usuario puede cambiar la página a CatalogDisplayMode y agregar una instancia previamente cerrada de un control a la página.Closing a control removes it from interaction on a page, although if developers provide the appropriate user interface (UI), such as a CatalogZone zone that contains a PageCatalogPart control, a user can switch the page into CatalogDisplayMode and add a previously closed instance of a control back to the page.

Se aplica a

Consulte también