--- lbbs/include/screen.h 2025/05/30 12:51:00 1.12 +++ lbbs/include/screen.h 2025/11/04 14:58:55 1.21 @@ -1,18 +1,10 @@ -/*************************************************************************** - screen.h - description - ------------------- - copyright : (C) 2004-2025 by Leaflet - email : leaflet@leafok.com - ***************************************************************************/ - -/*************************************************************************** - * * - * This program is free software; you can redistribute it and/or modify * - * it under the terms of the GNU General Public License as published by * - * the Free Software Foundation; either version 3 of the License, or * - * (at your option) any later version. * - * * - ***************************************************************************/ +/* SPDX-License-Identifier: GPL-3.0-or-later */ +/* + * screen + * - advanced telnet-based user interactive input / output features + * + * Copyright (C) 2004-2025 Leaflet + */ #ifndef _SCREEN_H_ #define _SCREEN_H_ @@ -20,8 +12,19 @@ #include #define CTRL_SEQ_CLR_LINE "\033[K" +#define MSG_EXT_MAX_LEN 400 -typedef int (*display_data_key_handler)(int *key, char *msg, size_t msg_len); +struct display_ctx_t +{ + int reach_begin; + int reach_end; + long line_top; + long line_bottom; + char msg[MSG_EXT_MAX_LEN]; +}; +typedef struct display_ctx_t DISPLAY_CTX; + +typedef int (*display_data_key_handler)(int *p_key, DISPLAY_CTX *p_ctx); extern void moveto(int row, int col); extern void clrtoeol(); @@ -30,18 +33,19 @@ extern void clrtobot(int line_begin); extern void clearscr(); extern int press_any_key(); +extern int press_any_key_ex(const char *msg, int sec); extern void set_input_echo(int echo); extern int str_input(char *buffer, int buffer_length, int echo_mode); -extern int get_data(int row, int col, char *prompt, char *buffer, int buffer_length, int echo_mode); +extern int get_data(int row, int col, char *prompt, char *buffer, int buffer_length, int max_display_len); // eof_exit = 0 : Do not exit at EOF // 1 : Prompt for any key at EOF, then exit // 2 : Exit at EOF without prompt -extern int display_data(const void *p_data, long line_total, const long *p_line_offsets, int begin_line, int eof_exit, +extern int display_data(const void *p_data, long display_line_total, const long *p_line_offsets, int eof_exit, display_data_key_handler key_handler, const char *help_filename); -extern int display_file(const char *filename, int begin_line, int eof_exit); +extern int display_file(const char *filename, int eof_exit); extern int show_top(const char *str_left, const char *str_center, const char *str_right); extern int show_bottom(const char *msg);