EditorZoneBase.OKVerb Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

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 aplica as alterações de edição a um controle no modo de edição e oculta a interface do usuário de edição.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ OKVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb OKVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.OKVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property OKVerb As WebPartVerb

Valor da propriedade

WebPartVerb

Um WebPartVerb que aplica alterações de edição a um controle e oculta a interface do usuário de edição.

Atributos: PersistenceModeAttribute

Exemplos

O exemplo de código a seguir demonstra como acessar a OKVerb propriedade de forma declarativa e programática. Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico de visão geral da EditorZoneBase classe.

A primeira parte do exemplo de código mostra como acessar a OKVerb propriedade declarativamente em uma página da Web. Este exemplo personaliza o texto para o verbo.

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

A segunda parte do exemplo mostra como acessar o OKVerb programaticamente usando um botão de alternância para habilitá-lo ou desabilitá-lo.

void Button4_Click(object sender, EventArgs e)
{
  if (EditorZone1.OKVerb.Enabled)
    EditorZone1.OKVerb.Enabled = false;
  else
    EditorZone1.OKVerb.Enabled = true;
}

Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
  If EditorZone1.OKVerb.Enabled Then
    EditorZone1.OKVerb.Enabled = False
  Else
    EditorZone1.OKVerb.Enabled = True
  End If

End Sub

Ao carregar a página em um navegador, você pode selecionar Editar Modo no controle de lista suspensa para alternar para o modo de edição. Você pode clicar no menu de verbos (a seta para baixo) na barra de título de um dos controles e clicar em Editar para editar o controle selecionado. Quando o EditorZone controle e a interface do usuário de edição estiverem visíveis, você poderá ver o botão que representa o verbo OK e clicar no botão Alternar OKVerb Habilitado para habilitá-lo ou desabilitá-lo.

Comentários

O verbo OK é referenciado pela OKVerb propriedade em um controle derivado da EditorZoneBase classe . É semelhante ao verbo apply, pois quando um usuário clica nele, ele aplica as alterações de edição que o usuário fez a um controle de servidor. Além disso, os controles de edição estão ocultos, o WebPart controle que estava sendo editado não está mais selecionado (o que permite que o usuário edite outro controle) e a página permanece no modo de edição.

Por padrão, o verbo OK aparece na interface do usuário como um Button controle. O tipo de botão pode ser uma imagem, um link ou um botão real; você pode definir isso para todos os botões de verbo em uma zona (não para botões individuais) definindo a propriedade herdada VerbButtonType no nível da zona.

O verbo OK é um controle de nível de zona, o que significa que, embora possa haver vários EditorPart controles, cada um editando uma ou mais propriedades para o controle de servidor que está no modo de edição, o verbo OK funciona universalmente para aplicar todas as alterações de todos os EditorPart controles na zona e ocultar todos os controles, exceto a própria zona.

Aplica-se a

Partilhar via