JMonkeyEngine3——NiftyGui CheckBox

CheckBox

 CheckBox 控件显示一个简单的复选框，用户可以选中或取消选中。可以使用 CheckBoxBuilder 类从 Java 动态创建复选框，也可以使用<control name="checkbox"></control> 标签从 XML 创建复选框。

常用属性

Name	Datatype	Default	Description
checked	boolean	false	CheckBox 的初始状态。“true”表示 CheckBox 默认选中，“false”表示 CheckBox 默认未选中。

EventBus Notification

CheckBox 支持 EventBus 通知任何改变 CheckBox 状态的操作。在这种情况下，将使用 CheckBox 的 ID 作为事件的主题来发布 CheckBoxStateChangedEvent。

Java Builder 示例

// Using the builder pattern
control(new CheckboxBuilder("multiSelectionCheckBox") {{
  checked(false); // start with uncheck
}});

XML 示例

<!-- simple default checkbox. please note: event notification requires an id -->
<control id="simpleCheckBox" name="checkbox" />

参考

https://github.com/nifty-gui/nifty-gui/wiki/CheckBox

案例

xml布局文件如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<nifty xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://nifty-gui.lessvoid.com/nifty-gui" xsi:schemaLocation="https://raw.githubusercontent.com/void256/nifty-gui/1.4/nifty-core/src/main/resources/nifty.xsd https://raw.githubusercontent.com/void256/nifty-gui/1.4/nifty-core/src/main/resources/nifty.xsd">
    <useControls filename="nifty-default-controls.xml"/>
    <useStyles filename="nifty-default-styles.xml"/>
    <screen id="screen0" controller="mygame.NiftyGuiTextField" >
        <layer id="layer0" childLayout="center">
            <panel id="panel0" height="57px" style="nifty-panel-simple" width="401px" align="center" childLayout="vertical" valign="center" y="-1px" x="-1px">
                <control name="textfield" id="textField0" text="user name" width="50%" align="center" valign="center" y="109" x="21"/>
                <control name="textfield" id="textField1" text="12355" width="50%" align="center" passwordChar="*" valign="center"/>
            </panel>
        </layer>
    </screen>
</nifty>

Java代码如下：

import com.jme3.app.SimpleApplication;
import com.jme3.math.ColorRGBA;
import com.jme3.niftygui.NiftyJmeDisplay;
import de.lessvoid.nifty.Nifty;
import de.lessvoid.nifty.NiftyEventSubscriber;
import de.lessvoid.nifty.controls.CheckBoxStateChangedEvent;
import de.lessvoid.nifty.controls.TextField;
import de.lessvoid.nifty.controls.TextFieldChangedEvent;
import de.lessvoid.nifty.screen.Screen;
import de.lessvoid.nifty.screen.ScreenController;

/**
 * @date 2024年7月12日16点25分
 * @author JohnKkk
 */
public class NiftyGuiCheckBox extends SimpleApplication implements ScreenController{

    private Nifty m_Nifty;
    
    public static void main(String[] args) {
        NiftyGuiCheckBox niftyGuiLabel = new NiftyGuiCheckBox();
        niftyGuiLabel.start();
    }
    
    @NiftyEventSubscriber(id="checkbox0")
    public final void onCheckBox0StateChangedEvent(final String id, final CheckBoxStateChangedEvent event){
        System.out.println("CheckBox:" + id + ",选中状态:" + event.getCheckBox().isChecked());
    }
    
    @NiftyEventSubscriber(id="checkbox1")
    public final void onCheckBox1StateChangedEvent(final String id, final CheckBoxStateChangedEvent event){
        System.out.println("CheckBox:" + id + ",选中状态:" + event.getCheckBox().isChecked());
    }
    
    @NiftyEventSubscriber(id="checkbox2")
    public final void onCheckBox2StateChangedEvent(final String id, final CheckBoxStateChangedEvent event){
        System.out.println("CheckBox:" + id + ",选中状态:" + event.getCheckBox().isChecked());
    }
    
    @Override
    public void simpleInitApp() {
        // 设置默认背景色
        getViewPort().setBackgroundColor(ColorRGBA.DarkGray);
        
        // 初始化Nifty
        NiftyJmeDisplay niftyDisplay = NiftyJmeDisplay.newNiftyJmeDisplay(
                assetManager,
                inputManager,
                audioRenderer,
                guiViewPort);
        m_Nifty = niftyDisplay.getNifty();
        // 将NiftyGUI显示对象添加到JME3中
        guiViewPort.addProcessor(niftyDisplay);
        
        m_Nifty.fromXml("Interface/NiftyGuiCheckBox.xml", "screen0");
        
        // 禁用flyCam并显示鼠标
        flyCam.setEnabled(false);
        inputManager.setCursorVisible(true);
    }

    @Override
    public void bind(Nifty arg0, Screen arg1) {
    }

    @Override
    public void onStartScreen() {
    }

    @Override
    public void onEndScreen() {
    }
    
}

注意到第25~38行，我们为三个CheckBox都订阅了EventBus事件执行函数。

启动JME3程序，执行结果如下：

 我们还可以通过<interact>标签（基本事件参考）来与Java代码交互。