/* TUI data manipulation routines.
Copyright (C) 1998-2020 Free Software Foundation, Inc.
Contributed by Hewlett-Packard Company.
This file is part of GDB.
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.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see . */
#ifndef TUI_TUI_DATA_H
#define TUI_TUI_DATA_H
#include "tui/tui.h"
#include "gdb_curses.h" /* For WINDOW. */
#include "observable.h"
/* A deleter that calls delwin. */
struct curses_deleter
{
void operator() (WINDOW *win) const
{
delwin (win);
}
};
/* Generic window information. */
struct tui_gen_win_info
{
protected:
tui_gen_win_info () = default;
/* This is called after the window is resized, and should update the
window's contents. */
virtual void rerender ()
{
}
virtual void make_window ();
public:
tui_gen_win_info (tui_gen_win_info &&) = default;
virtual ~tui_gen_win_info ()
{
}
/* Call to refresh this window. */
virtual void refresh_window ();
/* Make this window visible or invisible. */
virtual void make_visible (bool visible);
/* Return the name of this type of window. */
virtual const char *name () const
{
return "";
}
/* Compute the maximum height of this window. */
virtual int max_height () const = 0;
/* Compute the minimum height of this window. */
virtual int min_height () const = 0;
/* Compute the maximum width of this window. */
int max_width () const;
/* Compute the minimum width of this window. */
int min_width () const
{
return 3;
}
/* Return true if this window can be boxed. */
virtual bool can_box () const
{
return false;
}
/* Resize this window. The parameters are used to set the window's
size and position. */
virtual void resize (int height, int width,
int origin_x, int origin_y);
/* Return true if this window is visible. */
bool is_visible () const
{
return handle != nullptr;
}
/* Disable output until the next call to doupdate. */
virtual void no_refresh ()
{
if (handle != nullptr)
wnoutrefresh (handle.get ());
}
/* Window handle. */
std::unique_ptr handle;
/* Window width. */
int width = 0;
/* Window height. */
int height = 0;
/* Origin of window. */
int x = 0;
int y = 0;
};
/* Constant definitions. */
#define SRC_NAME "src"
#define CMD_NAME "cmd"
#define DATA_NAME "regs"
#define DISASSEM_NAME "asm"
#define STATUS_NAME "status"
#define MIN_WIN_HEIGHT 3
/* This defines information about each logical window. */
struct tui_win_info : public tui_gen_win_info
{
protected:
tui_win_info () = default;
DISABLE_COPY_AND_ASSIGN (tui_win_info);
/* Scroll the contents vertically. This is only called via
forward_scroll and backward_scroll. */
virtual void do_scroll_vertical (int num_to_scroll) = 0;
/* Scroll the contents horizontally. This is only called via
left_scroll and right_scroll. */
virtual void do_scroll_horizontal (int num_to_scroll) = 0;
void rerender () override;
void make_window () override;
public:
~tui_win_info () override
{
}
int max_height () const override;
int min_height () const override
{
return MIN_WIN_HEIGHT;
}
/* Called after the tab width has been changed. */
virtual void update_tab_width ()
{
}
/* Set whether this window is highlighted. */
void set_highlight (bool highlight)
{
is_highlighted = highlight;
}
/* Methods to scroll the contents of this window. Note that they
are named with "_scroll" coming at the end because the more
obvious "scroll_forward" is defined as a macro in term.h. */
void forward_scroll (int num_to_scroll);
void backward_scroll (int num_to_scroll);
void left_scroll (int num_to_scroll);
void right_scroll (int num_to_scroll);
/* Return true if this window can be scrolled, false otherwise. */
virtual bool can_scroll () const
{
return true;
}
bool can_box () const override
{
return true;
}
void check_and_display_highlight_if_needed ();
/* Window title to display. */
std::string title;
/* Is this window highlighted? */
bool is_highlighted = false;
};
/* Global Data. */
extern struct tui_win_info *tui_win_list[MAX_MAJOR_WINDOWS];
#define TUI_SRC_WIN ((tui_source_window *) tui_win_list[SRC_WIN])
#define TUI_DISASM_WIN ((tui_disasm_window *) tui_win_list[DISASSEM_WIN])
#define TUI_DATA_WIN ((tui_data_window *) tui_win_list[DATA_WIN])
#define TUI_CMD_WIN ((tui_cmd_window *) tui_win_list[CMD_WIN])
/* All the windows that are currently instantiated, in layout
order. */
extern std::vector tui_windows;
/* Return a range adapter for iterating over TUI windows. */
static inline std::vector &
all_tui_windows ()
{
return tui_windows;
}
/* Data Manipulation Functions. */
extern int tui_term_height (void);
extern void tui_set_term_height_to (int);
extern int tui_term_width (void);
extern void tui_set_term_width_to (int);
extern struct tui_locator_window *tui_locator_win_info_ptr (void);
extern struct tui_win_info *tui_win_with_focus (void);
extern bool tui_win_resized ();
extern void tui_set_win_resized_to (bool);
extern struct tui_win_info *tui_next_win (struct tui_win_info *);
extern struct tui_win_info *tui_prev_win (struct tui_win_info *);
extern unsigned int tui_tab_width;
#endif /* TUI_TUI_DATA_H */