com.dukescript.api.javafx.beans

Interface EventHandlerProperty

All Superinterfaces:

Observable, ObservableValue<T>, ReadOnlyProperty<EventHandler<? super ActionDataEvent>>

All Known Implementing Classes:

SimpleEventHandlerProperty

public interface EventHandlerProperty
extends ReadOnlyProperty<EventHandler<? super ActionDataEvent>>

Property representing an EventHandler. Use one of FXBeanInfo.Builder.action(java.lang.String, java.lang.Runnable) methods to create instance of the property rather than implementing the interface manually.

The following example defines a class with three action methods and then uses their handle references to register them into the builder:

class CountingBean implements FXBeanInfo.Provider {
    private int count;

    private void addAction(ActionEvent ev) {
        count += ((Number) ev.getSource()).intValue();
    }
    private void incrementAction() {
        count++;
    }
    private void addTwiceAction(ActionDataEvent ev) {
        count += ev.getSource(Number.class).intValue();
        count += ev.getProperty(Number.class, "any").intValue();
    }

    private final FXBeanInfo infoWithActions = FXBeanInfo.newBuilder(this)
                .action("actionWithEvent", this::addAction)
                .action("actionWithoutParameters", this::incrementAction)
                .action("actionWithData", this::addTwiceAction)
                .build();

    @Override
    public FXBeanInfo getFXBeanInfo() {
        return infoWithActions;
    }
}

The handler method may take no arguments, a single ActionEvent parameter or a single ActionDataEvent parameter. The registered methods are then accessible via FXBeanInfo.getActions() map.

There is also a way to register the actions directly via properties. Here is an example:

class CountingBean implements FXBeanInfo.Provider {
    private int count;

    final EventHandlerProperty incrementAction =
    new SimpleEventHandlerProperty(this, "actionWithoutParameters", (ev) -> {
        count++;
    });

    final EventHandlerProperty addAction =
    new SimpleEventHandlerProperty(this, "actionWithEvent", (ev) -> {
        count += ((Number) ev.getSource()).intValue();
    });

    final EventHandlerProperty addTwiceAction =
    new SimpleEventHandlerProperty(this, "actionWithData", (ev) -> {
        count += ev.getSource(Number.class).intValue();
        count += ev.getProperty(Number.class, "any").intValue();
    });

    private final FXBeanInfo info = FXBeanInfo.newBuilder(this)
        .action(this.incrementAction)
        .action(this.addAction)
        .action(this.addTwiceAction)
        .build();

    @Override
    public FXBeanInfo getFXBeanInfo() {
        return info;
    }
}

Since:

0.4

Method Summary

Methods inherited from interface javafx.beans.property.ReadOnlyProperty

getBean, getName

Methods inherited from interface javafx.beans.value.ObservableValue

addListener, getValue, removeListener

Methods inherited from interface javafx.beans.Observable

addListener, removeListener