ThemeableAttribute クラスとは何？わかりやすく解説 Weblio辞書

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

ThemeableAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

Web サーバーコントロールおよび Web サーバーコントロールのメンバで使用されるメタデータ属性を定義します。このメタデータ属性は、Web サーバーコントロールおよび Web サーバーコントロールのメンバの表示に、テーマまたはコントロールスキンを反映できるかどうかを示します。このクラスは継承できません。

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

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Property)>
 _
Public NotInheritable Class
 ThemeableAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As ThemeableAttribute

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property)] 
public sealed class ThemeableAttribute : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Property)] 
public ref class ThemeableAttribute sealed
 : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property)
 */ 
public final class ThemeableAttribute extends
 Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property) 
public final class ThemeableAttribute extends
 Attribute

解説

コントロールの開発者は ThemeableAttribute 属性を使用してコントロールの型およびコントロールのメンバを装飾し、テーマとコントロールスキンを反映できるかどうかを示します。既定では、コントロールによって公開されるすべてのプロパティにテーマを反映できます。ただし、一般的には、スタイルに関するプロパティにだけテーマが適用されるよう、スタイルに関係しないすべてのプロパティに明示的に Themeable(false) 属性を適用する必要があります。あるメンバを Themeable(false) 属性を使用して装飾すると、EnableTheming プロパティの値とは関係なく、そのメンバにはテーマを適用できなくなります。たとえば、ThemeableAttribute 属性をあるコントロールに適用して、false に設定すると、そのコントロールの EnableTheming プロパティを true に設定しても、そのコントロールにはテーマが反映されません。

ThemeableAttribute クラスでは、テーマをサポートするすべての型が含まれた静的な一覧が保持されます。また、この一覧は、静的メソッドである IsObjectThemeable および IsTypeThemeable が呼び出されるたびに参照されます。

使用例

ThemeableAttribute 属性をコントロールのメンバに適用する方法を次のコード例に示します。この例では、ThemeableAttribute をバインドコントロールに適用し、false を ThemeableAttribute コンストラクタに渡しています。これにより、DataSourceID メンバにテーマを適用できないことを示します (false をこのコンストラクタに渡すと、No フィールドに等しい ThemeableAttribute インスタンスになります)。

Visual Basic

Imports System
Imports System.Web.UI
Imports System.Web.UI.WebControls

Public Class SomeDataBoundControl
    Inherits DataBoundControl

    ' Implementation of a custom data source control.
    
    <Themeable(False)> _
    <IDReferenceProperty()>  _
    Public Overrides Property
 DataSourceID() As String 
        Get
            Return MyBase.DataSourceID
        End Get
        Set
            MyBase.DataSourceID = value
        End Set
    End Property
    
End Class 'SomeDataBoundControl

namespace Samples.AspNet.CS.Controls {
    using System;
    using System.Web.UI;
    using System.Web.UI.WebControls;
    
    
    public class SomeDataBoundControl : DataBoundControl
    {
        // Implementation of a custom data source control.
        
        [Themeable(false) ]
        [IDReferenceProperty()]
        public override string DataSourceID
 {
            get {
                return base.DataSourceID;
            }
            set {
                base.DataSourceID = value;
            }
        }
        
    }
}