89 lines
2.8 KiB
C
89 lines
2.8 KiB
C
//---
|
|
// JustUI.jfileselect: Basic file selector
|
|
//---
|
|
|
|
#ifndef _J_JFILESELECT
|
|
#define _J_JFILESELECT
|
|
|
|
#include <justui/defs.h>
|
|
#include <justui/jwidget.h>
|
|
#include <gint/display.h>
|
|
#include <dirent.h>
|
|
|
|
/* jfileselect: Basic file selector
|
|
|
|
This widget is used to browse the filesystem and select a file. Visually, it
|
|
only consists of a scrolling list of names showing a section of a folder's
|
|
entries.
|
|
|
|
TODO: jfileselect: Select a new file to write to
|
|
|
|
Events:
|
|
* JFILESELECT_LOADED when a folder is loaded into the view
|
|
* JFILESELECT_VALIDATED when a file has been selected
|
|
* JFILESELECT_CANCELED when if the user exits from the top-level folder */
|
|
typedef struct {
|
|
jwidget widget;
|
|
|
|
/* Folder currently being browsed */
|
|
char *path;
|
|
/* Corresponding directory stream */
|
|
DIR *dp;
|
|
/* Entry previously validated (with EXE) */
|
|
char *selected_file;
|
|
|
|
/* Number of entries in the current folder */
|
|
int folder_entries;
|
|
/* Current cursor position (0 .. folder_entries-1) */
|
|
int16_t cursor;
|
|
/* Current scroll position */
|
|
int16_t scroll;
|
|
/* Number of visible lines */
|
|
int8_t visible_lines;
|
|
|
|
/* Additional pixels of spacing per line (base is font->height) */
|
|
int8_t line_spacing;
|
|
/* Rendering font */
|
|
font_t const *font;
|
|
|
|
} jfileselect;
|
|
|
|
/* Type IDs */
|
|
extern uint16_t JFILESELECT_LOADED;
|
|
extern uint16_t JFILESELECT_VALIDATED;
|
|
extern uint16_t JFILESELECT_CANCELED;
|
|
|
|
/* jfileselect_create(): Create a file selection interface
|
|
|
|
There is no initial folder. The widget will not handle any events nor emit
|
|
any events in this state; a path must first be set before use. */
|
|
jfileselect *jfileselect_create(void *parent);
|
|
|
|
/* jfileselect_browse(): Browse a folder
|
|
|
|
This function loads the specified folder and allows the user to select a
|
|
file. (Remember to give the widget focus.) A JFILESELECT_LOADED event is
|
|
emitted immediately, and further events are emitted based on user inputs.
|
|
|
|
This function resets the selected file to NULL.
|
|
|
|
Returns true on success, false if the path does not exist or cannot be
|
|
browsed (in that case, check errno). */
|
|
bool jfileselect_browse(jfileselect *fs, char const *path);
|
|
|
|
/* jfileselect_selected_file(): Get the path to the selected file
|
|
|
|
The selected file is NULL until jfileselect_browse() is called and the user
|
|
selects a file in the interface. The returned pointer is owned by the
|
|
widget. */
|
|
char const *jfileselect_selected_file(jfileselect *fs);
|
|
|
|
/* jfileselect_current_folder(): Get the path to the current folder */
|
|
char const *jfileselect_current_folder(jfileselect *fs);
|
|
|
|
/* Trivial properties */
|
|
void jfileselect_set_font(jfileselect *fs, font_t const *font);
|
|
void jfileselect_set_line_spacing(jfileselect *fs, int line_spacing);
|
|
|
|
#endif /* _J_JFILESELECT */
|