便利方法

2024年8月29日 | 阅读 8 分钟

JavaFX 提供了便利方法，可以用来处理 JavaFX 应用程序中的事件。它们提供了一种简单的方式来创建和注册事件处理程序，以响应 KeyEvent、MouseEvent、ActionEvent、拖放事件等等。

Node 类包含各种事件处理程序属性，可以使用该类中定义的 setter 方法将其设置为用户定义的事件处理程序。

将 Node 类的 EventHandler 属性设置为用户定义的事件处理程序，会自动注册这些处理程序以接收相应的事件类型。

下表描述了 EventHandler 属性及其 setter 方法（便利方法）。

EventHandler 属性	描述	设置器方法
onContextMenuRequested	这是 ContextMenuEvent 类型的 EventHandler。它被分配给一个函数，该函数将在节点上请求上下文菜单时调用。	setOnContextMenuRequested(EventHandler value )
onDragDetected	这是 MouseEvent 类型的 EventHandler。它指示一个函数，该函数将在检测到拖动手势时调用。	setOnDragDetected(EventHandler value )
onDragDone	这是 DragEvent 类型的 EventHandler。	setOnDragDone(EventHandler value )
onDragDropped	这是 DragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在拖放操作期间释放鼠标时调用。	setOnDragDropped(EventHandler value )
onDragEntered	这是 DragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在拖动手势进入节点时调用。	setOnDragEntered(EventHandler value )
onDragExited	这是 DragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在拖动手势退出节点时调用。	setOnDragExited(EventHandler value )
onDragOver	这是 DragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在拖动手势在节点内进行时调用。	setOnDragOver(EventHandler value )
onInputMethodTextChanged	这是 InputMethodEvent 类型的 EventHandler。它被分配给一个函数，该函数将在 Node 具有焦点并且输入法文本已更改时调用。	setOnInputMethodTextChanged(EventHandler value )
onKeyPressed	这是 KeyEvent 类型的 EventHandler。它被分配给一个函数，该函数将在 Node 具有焦点并且按下键时调用。	setOnKeyPressed(EventHandler value )
onKeyReleased	这是 KeyEvent 类型的 EventHandler。它被分配给一个函数，该函数将在 Node 具有焦点并且释放键时调用。	setOnKeyReleased(EventHandler value )
onKeyTyped	这是 KeyEvent 类型的 EventHandler。它被分配给一个函数，该函数将在 Node 具有焦点并且键入键时调用。	setOnKeyTyped(EventHandler value )
onMouseClicked	这是 MouseEvent 类型的 EventHandler。它被分配给一个函数，该函数将在鼠标按钮在节点上单击时调用。	setOnMouseClicked(EventHandler value )
onMouseDragEntered	这是 MouseDragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在完全按下拖动释放手势进入节点时调用。	setOnMouseDragEntered(EventHandler value )
onMouseDragExited	这是 MouseDragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在完全按下拖动释放手势退出节点时调用。	setOnMouseDragExited(EventHandler value )
onMouseDragged	这是 MouseDragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在鼠标按钮被按下并在节点上拖动时调用。	setOnMouseDragged(EventHandler value )
onMouseDragOver	这是 MouseDragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在完全按下拖动释放手势在节点内进行时调用。	setOnMouseDragOver(EventHandler value )
onMouseDragReleased	这是 MouseDragEvent 类型的 EventHandler。它被分配给一个函数，该函数将在完全按下拖动释放手势在节点内结束时调用。	setOnMouseDragReleased(EventHandler value )
onMouseEntered	这是 MouseEvent 类型的 EventHandler。它被分配给一个函数，该函数将在鼠标进入节点时调用。	setOnMouseEntered(EventHandler value )
onMouseExited	这是 MouseEvent 类型的 EventHandler。它被分配给一个函数，该函数将在鼠标退出节点时调用。	setOnMouseExited(EventHandler value )
onMouseMoved	这是 MouseEvent 类型的 EventHandler。它被分配给一个函数，该函数将在鼠标在节点内移动且未按下任何按钮时调用。	setOnMouseMoved(EventHandler value )
onMousePressed	这是 MouseEvent 类型的 EventHandler。它被分配给一个函数，该函数将在鼠标按钮在节点上按下时调用。	setOnMousePressed(EventHandler value )
onMouseReleased	这是 MouseEvent 类型的 EventHandler。它被分配给一个函数，该函数将在鼠标按钮在节点上释放时调用。	setOnMouseReleased(EventHandler value )
onRotate	这是 RotateEvent 类型的 EventHandler。它被分配给一个函数，该函数将在节点上执行旋转操作时调用。	setOnRotate(EventHandler value )
onRotationFinished	这是 RotateEvent 类型的 EventHandler。它被分配给一个函数，该函数将在旋转手势结束时调用。	setOnRotationFinished(EventHandler value )
onRotationStarted	这是 RotateEvent 类型的 EventHandler。它被分配给一个函数，该函数将在首次检测到旋转手势时调用。	setOnRotationStarted(EventHandler value )
onScrollFinished	这是 ScrollEvent 类型的 EventHandler。它被分配给一个函数，该函数将在滚动操作结束时调用。	setOnScrollFinished(EventHandler value )
onScroll	这是 ScrollEvent 类型的 EventHandler。它被分配给一个函数，该函数将在执行滚动操作时调用。	setOnScroll(EventHandler value )
onScrollStarted	这是 ScrollEvent 类型的 EventHandler。它被分配给一个函数，该函数将在检测到滚动操作时调用。	setOnScrollStarted(EventHandler value )
onSwipeDown	这是 SwipeEvent 类型的 EventHandler。它被分配给一个函数，该函数将在节点上发生向下轻扫时调用。	setOnSwipeDown(EventHandler value )
onSwipeUP	这是 SwipeEvent 类型的 EventHandler。它被分配给一个函数，该函数将在节点上发生向上轻扫时调用。	setOnSwipeUP(EventHandler value )
onSwipeLeft	这是 SwipeEvent 类型的 EventHandler。它被分配给一个函数，该函数将在节点上发生向左轻扫时调用。	setOnSwipeLeft(EventHandler value )
onSwipeRight	这是 SwipeEvent 类型的 EventHandler。它被分配给一个函数，该函数将在节点上发生向右轻扫时调用。	setOnSwipeRight(EventHandler value )
onTouchMoved	这是 TouchEvent 类型的 EventHandler。它被分配给一个函数，该函数将在触摸点在节点上移动时调用。	setOnTouchMoved(EventHandler value )
onTouchReleased	这是 TouchEvent 类型的 EventHandler。它被分配给一个函数，该函数将在触摸点在节点上释放时调用。	setOnTouchReleased(EventHandler value )
onTouchStationary	这是 TouchEvent 类型的 EventHandler。它被分配给一个函数，该函数将在触摸点被按下并保持静止时调用。	setOnTouchStationary(EventHandler value )
onZoomFinished	这是 ZoomEvent 类型的 EventHandler。它被分配给一个函数，该函数将在缩放手势结束时调用。	setOnZoomFinished(EventHandler value )
onZoom	这是 ZoomEvent 类型的 EventHandler。它被分配给一个函数，该函数将在执行缩放手势时调用。	setOnZoom(EventHandler value )
onZoomStarted	这是 ZoomEvent 类型的 EventHandler。它被分配给一个函数，该函数将在检测到缩放手势时调用。	setOnZoomStarted(EventHandler value )

事件处理程序注册的便利方法具有以下格式：

其中事件类型是要通过定义的函数处理的事件的类型，例如，setOnMouseMoved() 将是为 Mouse_Moved 事件注册事件处理程序的便利方法。

setOnAction() 按钮操作示例

在以下示例中，说明了 setOnAction() 方法。当单击“播放”按钮时，调用使用 setOnAction() 方法注册的 EventHandler，并将其设置为旋转屏幕上的矩形。

“暂停”按钮也注册了 EventHandler，该 EventHandler 设置为停止矩形的旋转。

package application;
import javafx.animation.RotateTransition;
import javafx.application.Application;
import javafx.event.ActionEvent;
import javafx.event.EventHandler;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.paint.Color;
import javafx.scene.shape.Rectangle;
import javafx.stage.Stage;
import javafx.util.Duration;

public class EventHandlerExample extends Application {
  public static void main(String[] args) {
    Application.launch(args);
  }

  @Override
  public void start(Stage primaryStage) {
	
	// Creating Rectangle 
    Rectangle rect = new Rectangle(100,100,120,120);
    
    // Setting Stroke and colour for the rectangle 
    rect.setFill(Color.RED);
    rect.setStroke(Color.BLACK);
    
    // Instantiating RotateTransition class 
    RotateTransition rotate = new RotateTransition();
	
    //Setting properties for the Rotate Transition class 
    rotate.setAutoReverse(false);
	rotate.setByAngle(360);
	rotate.setCycleCount(500);
	rotate.setDuration(Duration.millis(500));
	rotate.setNode(rect);
	
	//Creating the play button 
    Button btn = new Button();
    
    //Setting properties for the play button 
    btn.setText("Play");
    btn.setTranslateX(100);
    btn.setTranslateY(250);
    
    //defining the convenience method to register the event handler to handle the Action event.    
    btn.setOnAction(new EventHandler<ActionEvent>() {
      public void handle(ActionEvent event) {
    	  
    	  rotate.play();
      }
    });
    
    //Creating the pause button 
    Button btn1 = new Button("Pause");
    
    //Setting propertied for the pause button 
    btn1.setTranslateX(160);
    btn1.setTranslateY(250);
    
    //Handling event for the pause button click event 
    btn1.setOnAction(new EventHandler<ActionEvent>() {

		@Override
		public void handle(ActionEvent arg0) {
			// TODO Auto-generated method stub
			rotate.pause();
		}
    	
	});
    
    //Configuring group and scene 
    Group root = new Group();
    Scene scene = new Scene(root, 400, 350);
    root.getChildren().addAll(btn,rect,btn1);
    primaryStage.setScene(scene);
    primaryStage.setTitle("Handling Events");
    primaryStage.show();
  }
}

setOnKeyEvent() 键事件示例

setOnKeyEvent() 方法可用于注册在节点上生成的键事件的事件处理程序逻辑。在以下示例中，创建了两个文本字段作为节点，在第一个文本字段中按下的键被设置为第二个文本字段中的文本。

package application;
import javafx.application.Application;
import javafx.event.EventHandler;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.control.TextField;
import javafx.scene.input.KeyEvent;
import javafx.scene.paint.Color;
import javafx.stage.Stage;
public class JavaFX_KeyEvent extends Application{

	@Override
	public void start(Stage primaryStage) throws Exception {
		
		// TODO Auto-generated method stub
		
		//Creating TextFields and setting position for them 
		TextField tf1 = new TextField();
		TextField tf2 = new TextField();
		tf1.setTranslateX(100);
		tf1.setTranslateY(100);
		tf2.setTranslateX(300);
		tf2.setTranslateY(100);
		
		//Handling KeyEvent for textfield 1 
		tf1.setOnKeyPressed(new EventHandler<KeyEvent>() {

			@Override
			public void handle(KeyEvent key) {
				// TODO Auto-generated method stub
				tf2.setText("Key Pressed :"+" "+key.getText());
			}
			
		});
		
		//setting group and scene 
		Group root = new Group();
		root.getChildren().addAll(tf2,tf1);
		Scene scene = new Scene(root,500,200,Color.WHEAT);
		primaryStage.setScene(scene);
		primaryStage.setTitle("Handling KeyEvent");
		primaryStage.show();
	}
	public static void main(String[] args) {
		launch(args);
	}

}