rofi/include/textbox.h

250 lines
5.6 KiB
C
Raw Normal View History

2015-07-27 08:17:12 +00:00
#ifndef ROFI_TEXTBOX_H
#define ROFI_TEXTBOX_H
#include <xkbcommon/xkbcommon.h>
2014-08-02 18:02:37 +00:00
#include <pango/pango.h>
#include <pango/pango-fontmap.h>
#include <pango/pangocairo.h>
2015-09-26 18:34:34 +00:00
#include <cairo.h>
#include "widget.h"
#include "x11-helper.h"
#include "keyb.h"
2014-08-02 18:02:37 +00:00
2016-01-07 07:54:24 +00:00
/**
* @defgroup Textbox Textbox
* @ingroup Widgets
*
* @{
*/
2015-09-26 18:34:34 +00:00
typedef struct
{
Widget widget;
2015-09-26 18:34:34 +00:00
unsigned long flags;
short cursor;
Color color_fg, color_bg;
char *text;
PangoLayout *layout;
int tbft;
int markup;
int changed;
cairo_surface_t *main_surface;
cairo_t *main_draw;
int update;
int blink;
guint blink_timeout;
} textbox;
2014-03-22 20:04:19 +00:00
typedef enum
{
TB_AUTOHEIGHT = 1 << 0,
TB_AUTOWIDTH = 1 << 1,
TB_LEFT = 1 << 16,
TB_RIGHT = 1 << 17,
TB_CENTER = 1 << 18,
TB_EDITABLE = 1 << 19,
TB_MARKUP = 1 << 20,
TB_WRAP = 1 << 21,
TB_PASSWORD = 1 << 22,
TB_INDICATOR = 1 << 23,
} TextboxFlags;
typedef enum
{
2014-11-24 19:35:28 +00:00
// Render font normally
2015-04-06 15:13:26 +00:00
NORMAL = 0,
URGENT = 1,
ACTIVE = 2,
2015-11-30 13:05:39 +00:00
SELECTED = 4,
MARKUP = 8,
2015-04-06 15:13:26 +00:00
// Alternating row.
2015-11-30 13:05:39 +00:00
ALT = 16,
2014-11-24 19:35:28 +00:00
// Render font highlighted (inverted colors.)
2015-11-30 13:05:39 +00:00
HIGHLIGHT = 32,
2015-04-06 15:13:26 +00:00
FMOD_MASK = ( ALT | HIGHLIGHT ),
2015-11-30 13:05:39 +00:00
STATE_MASK = ~( SELECTED | MARKUP | ALT | HIGHLIGHT )
} TextBoxFontType;
2015-09-26 18:34:34 +00:00
textbox* textbox_create ( TextboxFlags flags,
2014-03-22 20:04:19 +00:00
short x, short y, short w, short h,
TextBoxFontType tbft,
2015-02-03 07:21:59 +00:00
const char *text );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
* Free the textbox and all allocated memory.
*/
2014-03-22 20:04:19 +00:00
void textbox_free ( textbox *tb );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
* @param tbft The style of font to render.
*
2014-11-24 19:35:28 +00:00
* Set the font render style.
2014-11-24 19:22:44 +00:00
*/
void textbox_font ( textbox *tb, TextBoxFontType tbft );
2014-11-24 19:35:28 +00:00
/**
* @param tb Handle to the textbox
* @param text The text to show in the textbox
*
* Set the text to show. Cursor is moved to end (if visible)
*/
2015-02-03 07:21:59 +00:00
void textbox_text ( textbox *tb, const char *text );
2014-11-24 19:35:28 +00:00
/**
* @param tb Handle to the textbox
2016-07-29 06:32:34 +00:00
* @param draw The cairo object used to draw itself.
2014-11-24 19:35:28 +00:00
*
* Render the textbox.
*/
2015-09-26 18:34:34 +00:00
void textbox_draw ( textbox *tb, cairo_t *draw );
int textbox_keybinding ( textbox *tb, KeyBindingAction action );
2016-05-22 17:41:52 +00:00
/**
* @param tb Handle to the textbox
* @param pad The text to insert
* @param pad_len the length of the text
*
* The text should be one insert from a keypress.. the first gunichar is validated to be (or not) control
* return TRUE if inserted
*/
2016-08-23 22:39:56 +00:00
gboolean textbox_append_char ( textbox *tb, const char *pad, const int pad_len );
2014-11-24 19:35:28 +00:00
/**
* @param tb Handle to the textbox
*
* Move the cursor to the end of the string.
*/
2014-03-22 20:04:19 +00:00
void textbox_cursor_end ( textbox *tb );
2014-11-24 19:35:28 +00:00
/**
* @param tb Handle to the textbox
* @param pos New cursor position
*
* Set the cursor position (string index)
*/
2014-05-27 10:55:47 +00:00
void textbox_cursor ( textbox *tb, int pos );
2014-11-24 19:35:28 +00:00
/**
* @param tb Handle to the textbox
* @param pos The position to insert the string at
* @param str The string to insert.
* @param slen The length of the string.
2014-11-24 19:35:28 +00:00
*
* Insert the string str at position pos.
*/
2016-08-23 22:39:56 +00:00
void textbox_insert ( textbox *tb, const int pos, const char *str, const int slen );
2014-11-24 19:22:44 +00:00
2014-05-27 06:31:59 +00:00
/**
* Setup the cached fonts. This is required to do
* before any of the textbox_ functions is called.
* Clean with textbox_cleanup()
*/
void textbox_setup ( void );
2014-05-27 06:31:59 +00:00
/**
* Cleanup the allocated colors and fonts by textbox_setup().
*/
void textbox_cleanup ( void );
2014-05-27 06:31:59 +00:00
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
2014-11-24 19:35:28 +00:00
* Get the height of the textbox
2014-11-24 19:22:44 +00:00
*
2014-11-24 19:35:28 +00:00
* @returns the height of the textbox in pixels.
2014-11-24 19:22:44 +00:00
*/
2016-08-23 22:39:56 +00:00
int textbox_get_height ( const textbox *tb );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
2014-11-24 19:35:28 +00:00
* Get the width of the textbox
2014-11-24 19:22:44 +00:00
*
2014-11-24 19:35:28 +00:00
* @returns the width of the textbox in pixels.
2014-11-24 19:22:44 +00:00
*/
2016-08-23 22:39:56 +00:00
int textbox_get_width ( const textbox *tb );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
* Get the height of the rendered string.
*
2014-11-24 19:35:28 +00:00
* @returns the height of the string in pixels.
2014-11-24 19:22:44 +00:00
*/
2016-08-23 22:39:56 +00:00
int textbox_get_font_height ( const textbox *tb );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
* Get the width of the rendered string.
*
2014-11-24 19:35:28 +00:00
* @returns the width of the string in pixels.
2014-11-24 19:22:44 +00:00
*/
2016-08-23 22:39:56 +00:00
int textbox_get_font_width ( const textbox *tb );
2014-08-02 18:02:37 +00:00
2014-11-24 19:22:44 +00:00
/**
* Estimate the width of a character.
*
* @returns the width of a character in pixels.
*/
double textbox_get_estimated_char_width ( void );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
* Delete character before cursor.
*/
void textbox_cursor_bkspc ( textbox *tb );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
* Delete character after cursor.
*/
void textbox_cursor_del ( textbox *tb );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
* Move cursor one position backward.
*/
void textbox_cursor_dec ( textbox *tb );
2014-11-24 19:22:44 +00:00
/**
* @param tb Handle to the textbox
*
* Move cursor one position forward.
*/
void textbox_cursor_inc ( textbox *tb );
2014-11-24 19:35:28 +00:00
/**
* @param tb Handle to the textbox
* @param pos The start position
* @param dlen The length
*
* Remove dlen bytes from position pos.
*/
void textbox_delete ( textbox *tb, int pos, int dlen );
void textbox_moveresize ( textbox *tb, int x, int y, int w, int h );
int textbox_get_estimated_char_height ( void );
void textbox_set_pango_context ( PangoContext *p );
void textbox_set_pango_attributes ( textbox *tb, PangoAttrList *list );
2016-01-07 07:54:24 +00:00
PangoAttrList *textbox_get_pango_attributes ( textbox *tb );
2016-08-23 22:39:56 +00:00
/**
* @param tb Handle to the textbox
*
* @returns the visible text.
*/
const char *textbox_get_visible_text ( const textbox *tb );
2016-01-07 07:54:24 +00:00
/*@}*/
2015-07-27 08:17:12 +00:00
#endif //ROFI_TEXTBOX_H