属性（attribute）【cAlgo API】

クラスやメンバに属性を付与するAttribute

cBot作成時に生成されるテンプレートのクラス定義を見てみましょう。

namespace cAlgo.Robots{
    [Robot(TimeZone = TimeZones.UTC, AccessRights = AccessRights.None)]
    public class cTradersLife : Robot    {
        [Parameter(DefaultValue = 0.0)]
        public double Parameter { get; set; }

この２行目と4行目、プログラム経験のある方でもC#に馴染みがないと「この[カッコ]なに？」って感じですよね。

これはC#特有の構文で、クラスやメンバに属性(attribute)を付与するものです。

namespace cAlgo.Robots{
    [Robot(TimeZone = TimeZones.UTC, AccessRights = AccessRights.None)]
    // このクラス↓は(TimeZone=...)のRobotにします
    public class cTradersLife : Robot    {
        [Parameter(DefaultValue = 0.0)]
        // このメンバ↓は(DefaultValue=0.0）のParameterにします
        public double Parameter { get; set; }

Attributeの型名は基本的に～Attributeとなっていますが、指定するときは[Robot]のようにAttributeを省略できます。

Attributeのプロパティ

cAlgoで使用するAttributeはプロパティを持ちます。

[Robot(TimeZone = TimeZones.UTC, AccessRights = AccessRights.None)]の()内がプロパティです。「これは（アクセス権限はなくて、UTC標準のタイムゾーンで動く）Robotですよと指定してるわけです。

プロパティは一つ一つ　プロパティ名＝値　の形で指定する必要があります。名前付きのプロパティを持たずに[Levels(20.0, 80.0)]のように直接数字を指定するだけのものもあります。

cAlgo内での使い方

cAlgoでは「cTrader本体に使い方を教えてあげるラベル」程度に考えておけば構いません。ほぼcBotもしくはIndicatorを作成し始めるとき最初に設定で使うだけです。

しかもほぼテンプレートで自動出力されてるので、やることは[Robot]や[Indicator]のプロパティを変更したり、どれが[Parameter]でどれが[Output]か指定する程度です。

以下にcAlgoで定義されているAtrributeを一通り示します。なお、プロパティはコード上では {get; set;}ですが、Attributeのプロパティは使い方が全く異なるため {get; set;}の記述は省略します。

cBot作成で使用するAttribute

RobotAttribute

これが付与されたクラスはcBot本体として扱われます。

プロパティ

(AccessRights) AccessRights

アクセス権限を指定します。プログラムがcTraderの外側に手を出す場合にどこまでやっていいのか権限を指定します。.None以外にすると起動時に警告が出ます。

(TimeZone) TimeZone

タイムゾーンを指定します。BarのOpenTimeなどで取得した時の時間がこのタイムゾーンになります。DataTime.Nowなどは影響を受けませんので注意してください。

ParameterAttribute

付与されたメンバ変数はcBotやIndicatorの外部から設定できるパラメータとなります。詳細は別記事書きました。

プロパティ

(string) Name

パラメータの表示名を指定します。プロパティ名を記述せずに[Parameter("name", ...)]と指定します。指定しなければメンバ変数名がそのまま表示されます。(サンプルコード参照)

(メンバの型) DefaultValue

既定値を指定します。起動しようとしたときに最初から入ってる値です。実際のプロパティ自体の型はobjectですが、メンバの型を入れてください。

(string) Group

パラメータのグループを指定します。

(メンバの型) MinValue

パラメータの最小値を指定します。数値型専用。

(メンバの型) MaxValue

パラメータの最大値を指定します。数値型専用。

(double) Step

設定画面で上下ボタンを押したときのパラメータの増減値を指定します。

サンプルコード

public class HelloWorld : Robot {
    [Parameter("期間",DefaultValue = 25)]
    public int Period { get; set; }

インジケータ作成で使用するAttribute

上記ParameterAttributeに加えて下記を使います。

IndicatorAttribute

付与されたクラスはIndicatorとして扱われます。Robotと同じ２つのプロパティに加えて下記を持ちます。

プロパティ

(bool) IsOverlay

重ねて表示するか別窓で表示するか。指定しないとfalse（別窓表示）です。

(bool) AutoRescale

自動でスケール調整をするかどうか。IsOverlay=trueのインジケータで、trueだと画面にインジケーターを表示させるよう自動調整されます。IsOverlay=falseの場合は違いがよくわかりません。指定しないとtrueです。cTraderはRescale周りもうちょい頑張ってほしいです（愚痴）

(int) ScalePrecision

数値を表示する際の小数点以下の桁数を指定します。

OutputAttribute

付与されたメンバはインジケータの表示に使われます。

プロパティ

(string) Name

表示する名前を指定します。プロパティ名を記述せずに[Output("name", ...)]のように指定します。

(string) LineColor

ラインの色を指定します。既定値は"Green"です。

(PlotType) PlotType

表示するのが線か点かヒストグラムかをPlotTypeで指定します。既定値はPlotType.Lineです。

(LineStyle) LineStyle

ラインスタイルをLineStyleで指定します。既定値は普通の線LiseStyle.Solidです。

(double) Thickness

線の太さをしてします。既定値は1.0です。

(bool) IsHistogram

ヒストグラムにするかどうか。

LevelsAttribute

必要なら指定します。指定位置に基準線を表示させたいときに[Indicator]と並べて使います。

プロパティ

(double[]) Levels

水平線を表示する場所。プロパティ名は記述せずに[Lebels(20.0, 80.0)]のように指定します。必ず指定する必要があります。

CloudAttribute

一目均衡表の雲みたいなの作りたいときに。[Indicator]と並べて使います。付与すると2本のラインの間を雲みたいな表示にできます。

プロパティ

(string) FirstLineName　(string) SecondLineName

間を雲にしたい2本のラインのそれぞれの名前。プロパティ名を記述せずに[CloudAttribute("firstLine", "secondLine")]のように指定します。必ず指定する必要があります。

(Color) FirstColor

雲の色。指定しないと1本目のラインと同じ色になります。

(double) opacity

雲の不透明度。０～１の間の値で指定します。defaultは0.2。

関連する列挙型

Outputのプロパティで使用するPlotTypeとLineStyleは以下のメンバを指定します。

PlotType列挙型

LineStyle列挙型

ちなみにこれはChartTrendLineなどでも使用します。

その他cAlgoのAttribute

一応、リファレンスにあるので挙げておきますが、使いません。

(2021/7/20 追記）　気づいたら使えなくなっており、リファレンスからも消えています。ver4.0にて削除？

HideFromIntellisenceAttribute

旧式のメンバについていて、インテリセンスで表示されないようになっているみたいです。名前付きプロパティはありません。

System.ComponentModelの[EditorBrowsable(EditorBrowsableState.Never)]の組み込み環境版でしょうか。手元で試してみましたがよくわかりませんでした。同じアセンブリ内で機能しないとこも同様なのかもしれません。

でも、そもそも組み込み環境だと別アセンブリではインテリセンスがきいていない気がするんですけど・・・

余談ですが、attributeという用語はプログラミング言語によっては違う意味合いになったりしますので、検索の際はご注意を。