3

enumパラメータとして値をとらなければならないカスタム属性をxmlで定義しました。アプリケーションのR.attrビルドから自動的に生成されるJavaDocは、名前と値を使用してテーブルを作成しますenumが、説明列に入力することはできません。JavaDocに表示される説明を定義するにはどうすればよいですか?

enum定数を持つ属性の例:

<declare-styleable name="MyCustomView">
    <attr name="directions">
        <enum name="up" value="0" />
        <enum name="down" value="1" />
        <enum name="left" value="2" />
        <enum name="right" value="3" />
    </attr>
</declare-styleable>

directionPriority私が何を意味するかを示すために、inのJavaDocにandroid.R.attrは、「定数」、「値」、「説明」がすべて入力された、可能なすべての列挙型のテーブルがあります。

私は多くの調査を行い、説明を含めることができるかもしれないタグで試行錯誤の推測を試みましたが、役に立ちませんでした。誰かがこれを文書化する適切な方法を知っていますか?

4

1 に答える 1

3

解決策は、各列挙型の前にコメントを追加することです。これらのコメントは、列挙型の説明列に自動的に変換されます。

<declare-styleable name="MyCustomView">
    <attr name="directions">
        <!-- Go up! -->
        <enum name="up" value="0" />
        <!-- Go down! -->
        <enum name="down" value="1" />
        <!-- Go left! -->
        <enum name="left" value="2" />
        <!-- Go right! -->
        <enum name="right" value="3" />
    </attr>
</declare-styleable>
于 2013-02-13T07:39:32.643 に答える