CatalogZoneBase.SelectedPartLinkStyle プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CatalogZoneBase.SelectedPartLinkStyle プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在ゾーンで選択されている CatalogPart コントロールのスタイル属性を含むオブジェクトを取得します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 SelectedPartLinkStyle As Style

Visual Basic (使用法)

Dim instance As CatalogZoneBase
Dim value As Style

value = instance.SelectedPartLinkStyle

public Style SelectedPartLinkStyle { get; }

C++

public:
property Style^ SelectedPartLinkStyle {
    Style^ get ();
}

/** @property */
public Style get_SelectedPartLinkStyle ()

JScript

public function get SelectedPartLinkStyle
 () : Style

プロパティ値
現在選択されているコントロールのスタイル属性を含む Style。

解説

CatalogZoneBase ゾーンでは、CatalogPart コントロールの各タイプ、つまり PageCatalogPart、DeclarativeCatalogPart、および ImportCatalogPart のリンクが表示されます。ユーザーがいずれかのリンクをクリックすると、対応する CatalogPart コントロールが選択済みのコントロールとなり、それに含まれる子コントロールが表示されます。

SelectedPartLinkStyle プロパティによって参照される Style オブジェクトには、現在選択されている CatalogPart コントロールのリンクのスタイル属性が含まれます。そのプロパティによって参照されるオブジェクトは読み取り専用ですが、それを使用して、選択されている CatalogPart コントロールの、基になるスタイル特性を設定することはできます。

使用例

SelectedPartLinkStyle プロパティの使用方法を次のコード例に示します。宣言を使用した方法とプログラムを使用した方法の 2 とおりの方法を紹介します。例の実行に必要なコード全体については、CatalogZoneBase クラスの概要で「例」を参照してください。

コード例の最初の部分では、2 つの <asp:catalogzone> 要素を宣言しており、1 つ目は SelectedPartLinkStyle プロパティの値を宣言しています。

Visual Basic

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

コード例の 2 番目の部分では、選択されている CatalogPart コントロールのテキストの色が別の値に設定されます。

Visual Basic

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

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

ブラウザでページを読み込む場合、ドロップダウンリストコントロールの [カタログ] を選択して、カタログ表示モードに切り替えることができます。カタログが表示されたら、一覧表示されている CatalogPart コントロールのいずれかのリンクをクリックし、選択しているコントロールのスタイル属性を確認します。[Change Part Link Styles] ボタンをクリックすると、選択しているコントロールのテキストの色を変更できます。また、選択されていないコントロールのリンクをクリックして、コントロールが選択されたときのスタイル属性の変化を確認できます。