LayoutEditorPart.Title Property

Definition

Gets or sets a title for the editor control.

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

Property Value

A string that is used as the title of the control. The default value is a calculated control name supplied by the Web Parts control set.

Examples

This code example demonstrates how to use the Title property of a LayoutEditorPart control. For the full code required to run the example, see the Example section of the LayoutEditorPart class overview.

The following code shows how to set the title on a LayoutEditorPart control declaratively in a Web page.

<asp:EditorZone ID="EditorZone1" runat="server" 
  style="z-index: 102; left: 340px; position: absolute; top: 90px" 
  Width="170px">
  <ZoneTemplate>
    <asp:LayoutEditorPart ID="LayoutEditorPart1" runat="server" 
      Title="My Layout Editor" OnPreRender="LayoutEditorPart1_PreRender" />
  </ZoneTemplate>
</asp:EditorZone>
<asp:EditorZone ID="EditorZone1" runat="server" 
  style="z-index: 102; left: 340px; position: absolute; top: 90px" 
  Width="170px">
  <ZoneTemplate>
    <asp:LayoutEditorPart ID="LayoutEditorPart1" runat="server" 
      Title="My Layout Editor" 
      OnPreRender="LayoutEditorPart1_PreRender" />
  </ZoneTemplate>
</asp:EditorZone>

The next part of the code example shows how to set the value of the Title property programmatically.

protected void Button1_Click(object sender, EventArgs e)
{
  LayoutEditorPart1.Title = Server.HtmlEncode(TextBox1.Text);
}
Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As System.EventArgs)
  LayoutEditorPart1.Title = Server.HtmlEncode(TextBox1.Text)
End Sub

When you load the page in a browser, you can select Edit Mode in the Display Mode drop-down list control to switch to edit mode. You can click the verbs menu (the downward arrow) in the title bar of the Author List WebPart control, and click Edit to begin editing. When the editing user interface (UI) is visible, you can see the LayoutEditorPart control, and a button and text box positioned above it. Note that the title of the LayoutEditorPart control is the value assigned to it in the declarative markup of the Web page. If you enter some text in the text box next to the Update EditorPart Title button, and then click the button, the title for the control is updated.

Remarks

The Title property value is displayed in the title bar of a LayoutEditorPart control when the control is visible in edit mode. When the control is declared in a page, you can set a value for the Title attribute. If you do not supply a value for the title, a culture-specific default value is used to describe the properties that this control allows users to edit.

Applies to

See also