CatalogZoneBase.SelectedPartLinkStyle Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft ein Objekt ab, das Stilattribute für das in der Zone derzeit ausgewählte CatalogPart-Steuerelement enthält.

public:
 property System::Web::UI::WebControls::Style ^ SelectedPartLinkStyle { System::Web::UI::WebControls::Style ^ get(); };

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

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.SelectedPartLinkStyle : System.Web.UI.WebControls.Style

Public ReadOnly Property SelectedPartLinkStyle As Style

Eigenschaftswert

Style

Ein Style, der Stilattribute für das derzeit ausgewählte Steuerelement enthält.

Attribute

PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SelectedPartLinkStyle Eigenschaft deklarativ und programmgesteuert verwendet wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der CatalogZoneBase Klassenübersicht.

Beachten Sie, dass der erste Teil des Codebeispiels zwei <asp:catalogzone> Elemente deklariert und das erste einen Wert für die SelectedPartLinkStyle -Eigenschaft deklariert.

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

Im zweiten Teil des Codebeispiels wird die Textfarbe für das ausgewählte CatalogPart Steuerelement auf einen anderen Wert festgelegt.

protected void Button5_Click(object sender, EventArgs e)
{
  CatalogZone1.PartLinkStyle.ForeColor = System.Drawing.Color.Red;
  CatalogZone1.SelectedPartLinkStyle.ForeColor = 
    System.Drawing.Color.Blue;
}

Protected Sub Button5_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  CatalogZone1.PartLinkStyle.ForeColor = _
    System.Drawing.Color.Red
  CatalogZone1.SelectedPartLinkStyle.ForeColor = _
    System.Drawing.Color.Blue
End Sub

Wenn Sie die Seite in einem Browser laden, können Sie in der Dropdownliste Katalog auswählen, um in den Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, klicken Sie auf den Link für eines der aufgelisteten CatalogPart Steuerelemente, und beachten Sie die Stilattribute des ausgewählten Steuerelements. Sie können auf die Schaltfläche Teilelinkformatvorlagen ändern klicken, um die Textfarbe des ausgewählten Steuerelements zu ändern. Sie können auch auf die Links für die nicht ausgewählten Steuerelemente klicken, um zu sehen, wie sich die Stilattribute ändern, wenn ein Steuerelement ausgewählt wird.

Hinweise

In einer CatalogZoneBase Zone werden Links für jeden Steuerelementtyp CatalogPart angezeigt: PageCatalogPart, DeclarativeCatalogPartund ImportCatalogPart. Wenn ein Benutzer auf einen der Links klickt, wird das entsprechende CatalogPart Steuerelement zum ausgewählten Steuerelement, und die untergeordneten Steuerelemente, die in diesem ausgewählten Steuerelement enthalten sind, werden sichtbar.

Das Style Objekt, auf das von der SelectedPartLinkStyle -Eigenschaft verwiesen wird, enthält die Stilattribute des Links für das CatalogPart steuerelement, das derzeit ausgewählt ist. Obwohl das Objekt, auf das von der -Eigenschaft verwiesen wird, schreibgeschützt ist, können Sie es dennoch verwenden, um die zugrunde liegenden Stilmerkmale für das ausgewählte CatalogPart Steuerelement festzulegen.

Weitere Informationen

• Style
• ASP.NET Webparts-Steuerelemente