FancyMenu Wiki/自定义Visibility Requirements：修订间差异

=== 不同类型的Requirements ===

VisibilityRequirements可以用于两种不同的模式。

第一种是不使用任何值来检查是否满足 Requirements ，第二种是使用一个值。

如果 Requirements 使用值，那么用户在给一个元素设置 Requirements 时就需要输入这个值。

=== 不使用值来创建 Requirements ===

同时有一些特殊的点需要特别留意一下。

在构造方法中给你的 Requirements 定义唯一标识符。

public ExampleVisibilityRequirement() {

//The identifier needs to be unique! It's not possible to register multiple requirements with the same identifier!

super("example_requirement_no_value");

}

这个方法用于返回 Requirements 是否需要值。

@Override

public boolean hasValue() {

return false;

}

这是你的 Requirements 的最重要的方法。

这里用于返回是否满足在此要求中检查的条件。

这个方法以 Requirements 的值为参数，但因为这个 Requirements 没有值，所以参数为空。

//Here you return if the requirement is met (using the given requirement value if the requirement has one).

//在这里返回是否满足 Requirements (如果 Requirements 有值则返回 Requirements 的值)

 

}

这个方法返回 Requirements 的显示名。

这个显示名会在布局编辑器的Visibility Requirements选项显示。

//This is the display name of the requirement.

//这个是 Requirements 的显示名。

return "Example Requirement [No Value]";

}

返回 Requirements 的描述。

当把鼠标悬停在切换 Requirements 按钮上时，该描述会作为工具提示显示。

//This is the description of the requirement.

//这里是 Requirements 的描述

return l;

}

这个方法返回值的显示名。

因为咱的 Requirements 不用值，返回空即可。

//Since this requirement has no value, just return NULL here.

//因为 Requirements 没有值，只需要在这里返回null。

return null;

}

返回自动设置到值输入文本字段的内容。

//No value, so just return NULL.

//没有值，返回null。

return null;

}

该方法返回一个字符过滤器，该过滤器用来检查用户可以在数值输入文本字段中允许输入的字符。

//You know the drill. No value = return NULL.

//没值 = 返回null（毁灭吧，我累了 *发动地鸣）

return null;

}

这个是完整的VisibilityRequirement样例。

package de.keksuccino.fancymenu.api.visibilityrequirements.example;

 

 

}

到这你几乎完成了。(译者：我也是 *冰箱里拿一瓶啤酒)

package de.keksuccino.fancymenu;

 

 

}

 

=== 创建带值的Requirement ===

创建<code>VisibilityRequirement</code>的新子类并取一个合适的名字。

 

 

 

构造函数用标识符独一无二

public ExampleVisibilityRequirementWithValue() {

//The identifier needs to be unique! It's not possible to register multiple requirements with the same identifier!

super("example_requirement_with_value");

}

这个方法用于返回 Requirements 是否需要值。

因为我们想给这个 Requirements 使用值，所以返回true。

@Override

public boolean hasValue() {

return true;

}

 

这是你的 Requirements 的最重要的方法。

这里用于返回是否满足在此要求中检查的条件。

这个方法有 Requirements 的值作为参数，所以你可以使用它检查是否满足 Requirements 。

//Here you return if the requirement is met (using the given requirement value if the requirement has one).

//在这里返回是否满足 Requirements (如果 Requirements 有值则返回 Requirements 的值)

 

}

 

此方法返回 Requirements 显示名。

这个显示名会在布局编辑器的Visibility Requirements选项显示。

//This is the display name of the requirement.

//这个是 Requirements 的显示名。

return "Example Requirement [With Value]";

}

 

返回 Requirements 的描述。

当把鼠标悬停在切换 Requirements 按钮上时，该描述会作为工具提示显示。

//This is the description of the requirement.

//这里是 Requirements 的描述

return l;

}

这个方法返回值的显示名。

//This is the display name of the VALUE of the requirement.

//这是 Requirements 的值的显示名。

return "Example Value Name";

}

 

最好给用户展示真实值的样例。

//This is the content that will be automatically set to the value input field when there is no value already.

//在已经没有值的情况下将自动设置到值输入栏的内容。

return "cool value preset";

}

该方法返回一个字符过滤器，该过滤器被用来检查用户可以在数值输入文本字段中允许输入的字符。

//The character filter of the value input field. Return NULL if you want to allow all characters.

//值输入字段字符过滤器，返回null允许所有字符。

return null;

}

package de.keksuccino.fancymenu.api.visibilityrequirements.example;

 

 

}

 

package de.keksuccino.fancymenu;

 

 

}