3

我在 xml 中定义了一个自定义属性，该属性必须将enum值作为参数。从我的应用程序自动生成的 JavaDocR.attr构建了一个包含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>

为了说明我的意思，directionPriorityin的 JavaDocandroid.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 回答