共用方式為

CatalogZoneBase.PartLinkStyle 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

取得包含 CatalogPart 控制項之樣式屬性的物件，而這些控制項目前在區域中並未選取。

public:
 property System::Web::UI::WebControls::Style ^ PartLinkStyle { System::Web::UI::WebControls::Style ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.Style PartLinkStyle { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.PartLinkStyle : System.Web.UI.WebControls.Style
Public ReadOnly Property PartLinkStyle As Style

屬性值

Style

Style，包含目前未選取之控制項的樣式屬性。

屬性
PersistenceModeAttribute

範例

下列程式代碼範例示範如何以宣告方式和程序設計方式使用 PartLinkStyle 屬性。 如需執行範例所需的完整程式碼，請參閱類別概觀的 CatalogZoneBase 範例一節。

請注意，程式代碼範例的第一個部分會宣告兩 <asp:catalogzone> 個元素，而第一個部分則宣告 屬性的值 PartLinkStyle 。

<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." />

在程式代碼範例的第二個部分中，未選取 CatalogPart 控件的文字色彩會設定為不同的值。

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

當您在瀏覽器中載入頁面時，您可以從下拉式清單中選取 [ 目錄 ]，以切換至目錄顯示模式。 當目錄可見時，請注意區域 (所列之未選取 CatalogPart 控件的樣式屬性，選取 CatalogPart 的控件是 DeclarativeCatalogPart 控件) 。 您可以按下 [ 變更元件鏈接樣式 ] 按鈕，變更未選取控件的文字色彩。 您也可以按下未選取控件的連結，以查看選取控件時樣式屬性的變更方式。

備註

CatalogZoneBase在區域中，每個控制項類型CatalogPart都會顯示連結：PageCatalogPart、 DeclarativeCatalogPart和 ImportCatalogPart。 當使用者按兩下其中一個連結時，對應的 CatalogPart 控制項會變成選取的控制項，而該選取控制項所包含的子控件會變成可見。

屬性 Style 所 PartLinkStyle 參考的物件包含目前未選取之控件的 CatalogPart 樣式屬性。 雖然 屬性所參考的對像是唯讀的，但您仍然可以使用它來設定未選取 CatalogPart 控件的基礎樣式特性。

適用於

另請參閱