PropertyGridEditorPart.Title 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.
Recebe ou define um título para o controlo do editor.
public:
virtual property System::String ^ Title { System::String ^ get(); void set(System::String ^ value); };
public override string Title { get; set; }
member this.Title : string with get, set
Public Overrides Property Title As String
Valor de Propriedade
Uma corda que é usada como nome do controlo. O valor padrão é um nome de controlo calculado fornecido pelo conjunto de controlos Web Parts.
Exemplos
Este exemplo de código demonstra como usar a Title propriedade de um PropertyGridEditorPart controlo. Para o código completo necessário para executar o exemplo, consulte a secção Exemplo do PropertyGridEditorPart tópico de visão geral da aula.
O exemplo de código seguinte mostra como definir o título num PropertyGridEditorPart controlo de forma declarativa numa página Web.
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:PropertyGridEditorPart ID="PropertyGridEditorPart1"
runat="server"
Title="Edit Custom Properties"
OnPreRender="PropertyGridEditorPart1_PreRender"
OnInit="PropertyGridEditorPart1_Init" />
</ZoneTemplate>
</asp:EditorZone>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:PropertyGridEditorPart ID="PropertyGridEditorPart1"
runat="server"
Title="Edit Custom Properties"
OnPreRender="PropertyGridEditorPart1_PreRender"
OnInit="PropertyGridEditorPart1_Init" />
</ZoneTemplate>
</asp:EditorZone>
A parte seguinte do exemplo de código mostra como definir o valor da Title propriedade programaticamente. Para persistir o valor atribuído programaticamente, é usada uma variável estática nomeada editControlTitle , e este valor é atribuído à Title propriedade cada vez que o controlo é inicializado, de modo a que o valor persiste entre eventos de postback.
private static String editControlTitle;
protected void Button1_Click(object sender, EventArgs e)
{
editControlTitle = Server.HtmlEncode(TextBox1.Text);
PropertyGridEditorPart1.Title = editControlTitle;
}
protected void PropertyGridEditorPart1_Init(object sender, EventArgs e)
{
if (editControlTitle != null)
PropertyGridEditorPart1.Title = editControlTitle;
}
Shared editControlTitle As String
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs)
editControlTitle = Server.HtmlEncode(TextBox1.Text)
PropertyGridEditorPart1.Title = editControlTitle
End Sub
Protected Sub PropertyGridEditorPart1_Init(ByVal _
sender As Object, ByVal e As System.EventArgs)
If Not editControlTitle Is Nothing Then
PropertyGridEditorPart1.Title = editControlTitle
End If
End Sub
Quando carregas a página num navegador, podes selecionar Modo Editar no menu suspenso de controlo da lista para mudar para o modo de edição. Pode clicar no menu de verbos (a seta para baixo) na barra de título do controlo da WebPart de Informação do Utilizador e clicar em Editar para começar a editar. Quando a interface de edição (UI) está visível, pode ver o PropertyGridEditorPart controlo, um botão e uma caixa de texto posicionados acima dela. Note que o título do PropertyGridEditorPart controlo é o valor atribuído a ele na marcação declarativa da página Web. Se inserires algum texto na caixa de texto ao lado do botão Atualizar Editor Part Title e depois clicares no botão, o título do controlo é atualizado.
Observações
O valor da Title propriedade é apresentado na barra de título de um PropertyGridEditorPart controlo quando este está visível em modo de edição. Quando o controlo é declarado numa página, pode definir um valor para o Title atributo. Se não fornecer um valor para o título, é fornecido um valor padrão específico da cultura.
A Title propriedade sobrepõe-se à propriedade base, de modo que, se não for fornecido valor de título, um título padrão apropriado a um PropertyGridEditorPart controlo pode ser fornecido pelo conjunto de controlos Web Parts.