ToolZone.EditUIStyle Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft die Stilattribute für die in einem ToolZone-Steuerelement enthaltenen bearbeitbaren Steuerelemente ab.

C#

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.Style EditUIStyle { get; }

Eigenschaftswert

Style

Ein Style, der Stilattribute für bearbeitbare Steuerelemente in einem ToolZone-Steuerelement enthält.

Attribute

PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die EditUIStyle -Eigenschaft mit einem geerbten Steuerelement verwendet wird ToolZone . Insbesondere wird veranschaulicht, wie die EditUIStyle Eigenschaft für Benutzeroberflächenelemente in einem EditorZone Steuerelement geändert wird.

Der erste Teil des Codebeispiels ist ein Benutzersteuerelement, auf das auf der Seite verwiesen wird, und ermöglicht es Ihnen, die Seite in verschiedene Anzeigemodi zu wechseln. Weitere Informationen zu Anzeigemodi und zum Aktivieren eines Wechsels von Benutzern finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webpartseite.

ASP.NET (C#)

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

Der zweite Teil des Codebeispiels ist die Webseite. Die Seite enthält ein EditorZone Steuerelement, das von der ToolZone -Klasse erbt. Die Button1_Click -Methode auf der Seite legt die EditUIStyle -Eigenschaft fest. Beachten Sie, dass Sie nach dem Laden der Seite in den Bearbeitungsmodus wechseln müssen, um die Auswirkungen der EditUIStyle Eigenschaft auf die Benutzeroberfläche des EditorZone Steuerelements zu sehen. Wenn Sie auf die Schaltfläche " Benutzeroberflächenschriftart ändern" klicken, müssen Sie feststellen, dass sich die Schriftart der bearbeitbaren Steuerelemente in der Zone ändert.

ASP.NET (C#)

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<script runat="server">

  void Button1_Click(object sender, EventArgs e)
  {
    EditorZone1.EditUIStyle.Font.Bold = true;
  }
</script>
<head runat="server">
    <title>Tool Zone Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" Runat="server" />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" Runat="server" >
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">MSDN</asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">ASP.NET</asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">MSN</asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone 
        ID="EditorZone1" 
        Runat="server">
        <EditUIStyle BackColor="#6699cc" />
        <ZoneTemplate>
          <asp:AppearanceEditorPart ID="AppearanceEditorPart1" Runat="server" />
          <asp:LayoutEditorPart ID="LayoutEditorPart1" Runat="server" /> 
        </ZoneTemplate>
      </asp:EditorZone>
      <asp:Button ID="Button1" Runat="server" Text="Change Edit UI Font" OnClick="Button1_Click" />
      </div>
    </form>
</body>
</html>

Hinweise

Mit EditUIStyle der -Eigenschaft können Sie auf Stilmerkmale für die bearbeitbaren Steuerelemente zugreifen, die in einem ToolZone Steuerelement enthalten sind. Bearbeitbare Steuerelemente werden von den abgeleiteten ToolZone Zonen gerendert und enthalten Steuerelemente wie TextBox, DropDownListund CheckBox Steuerelemente, mit denen Benutzer Eigenschaftswerte für WebPart Steuerelemente bearbeiten können. Die in der EditUIStyle -Eigenschaft enthaltenen Stilmerkmale gelten für die bearbeitbaren Steuerelemente, die zusammen die bearbeitungsfähige Benutzeroberfläche (UI) bilden, die benutzern angezeigt wird.

Hinweis

Obwohl die Eigenschaft schreibgeschützt ist, können Sie die Stilattribute des zugrunde liegenden Style Objekts festlegen.

Gilt für:

Weitere Informationen

• ASP.NET Webpart-Steuerelemente