mirror of
https://github.com/lbonn/rofi
synced 2024-11-16 08:58:05 +00:00
294 lines
7 KiB
C
294 lines
7 KiB
C
#ifndef ROFI_TEXTBOX_H
|
|
#define ROFI_TEXTBOX_H
|
|
|
|
#include <xkbcommon/xkbcommon.h>
|
|
#include <pango/pango.h>
|
|
#include <pango/pango-fontmap.h>
|
|
#include <pango/pangocairo.h>
|
|
#include <cairo.h>
|
|
#include "widgets/widget.h"
|
|
#include "widgets/widget-internal.h"
|
|
#include "x11-helper.h"
|
|
#include "keyb.h"
|
|
|
|
/**
|
|
* @defgroup Textbox Textbox
|
|
* @ingroup widget
|
|
*
|
|
* @{
|
|
*/
|
|
/**
|
|
* Internal structure of a textbox widget.
|
|
* @TODO make this internal to textbox
|
|
*/
|
|
typedef struct
|
|
{
|
|
widget widget;
|
|
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;
|
|
|
|
/**
|
|
* Flags for configuring textbox behaviour and looks during creation.
|
|
*/
|
|
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;
|
|
/**
|
|
* Flags indicating current state of the textbox.
|
|
*/
|
|
typedef enum
|
|
{
|
|
/** Normal */
|
|
NORMAL = 0,
|
|
/** Text in box is urgent. */
|
|
URGENT = 1,
|
|
/** Text in box is active. */
|
|
ACTIVE = 2,
|
|
/** Text in box is selected. */
|
|
SELECTED = 4,
|
|
/** Text in box has pango markup. */
|
|
MARKUP = 8,
|
|
|
|
/** Text is on an alternate row */
|
|
ALT = 16,
|
|
/** Render font highlighted (inverted colors.) */
|
|
HIGHLIGHT = 32,
|
|
/** Mask for alternate and highlighted */
|
|
FMOD_MASK = ( ALT | HIGHLIGHT ),
|
|
/** Mask of bits indicating state */
|
|
STATE_MASK = ~( SELECTED | MARKUP | ALT | HIGHLIGHT )
|
|
} TextBoxFontType;
|
|
|
|
/**
|
|
* @param flags #TextboxFlags indicating the type of textbox.
|
|
* @param x horizontal positon of textbox
|
|
* @param y vertical position of textbox
|
|
* @param w width of textbox
|
|
* @param h height of textbox
|
|
* @param tbft #TextBoxFontType current state of textbox.
|
|
* @param text intial text to display.
|
|
*
|
|
* Create a new textbox widget.
|
|
*
|
|
* free with #widget_free
|
|
* @returns a new #textbox
|
|
*/
|
|
textbox* textbox_create ( TextboxFlags flags,
|
|
short x, short y, short w, short h,
|
|
TextBoxFontType tbft,
|
|
const char *text );
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
* @param tbft The style of font to render.
|
|
*
|
|
* Set the font render style.
|
|
*/
|
|
void textbox_font ( textbox *tb, TextBoxFontType tbft );
|
|
|
|
/**
|
|
* @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)
|
|
*/
|
|
void textbox_text ( textbox *tb, const char *text );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
* @param action the #KeyBindingAction to execute on textbox
|
|
*
|
|
* Execute an action on the textbox.
|
|
*
|
|
* @return TRUE if action was taken.
|
|
*/
|
|
int textbox_keybinding ( textbox *tb, KeyBindingAction action );
|
|
/**
|
|
* @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
|
|
*/
|
|
gboolean textbox_append_char ( textbox *tb, const char *pad, const int pad_len );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Move the cursor to the end of the string.
|
|
*/
|
|
void textbox_cursor_end ( textbox *tb );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
* @param pos New cursor position
|
|
*
|
|
* Set the cursor position (string index)
|
|
*/
|
|
void textbox_cursor ( textbox *tb, int pos );
|
|
|
|
/**
|
|
* @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.
|
|
*
|
|
* Insert the string str at position pos.
|
|
*/
|
|
void textbox_insert ( textbox *tb, const int pos, const char *str, const int slen );
|
|
|
|
/**
|
|
* 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 );
|
|
|
|
/**
|
|
* Cleanup the allocated colors and fonts by textbox_setup().
|
|
*/
|
|
void textbox_cleanup ( void );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Get the height of the textbox
|
|
*
|
|
* @returns the height of the textbox in pixels.
|
|
*/
|
|
int textbox_get_height ( const textbox *tb );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Get the height of the rendered string.
|
|
*
|
|
* @returns the height of the string in pixels.
|
|
*/
|
|
int textbox_get_font_height ( const textbox *tb );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Get the width of the rendered string.
|
|
*
|
|
* @returns the width of the string in pixels.
|
|
*/
|
|
int textbox_get_font_width ( const textbox *tb );
|
|
|
|
/**
|
|
* Estimate the width of a character.
|
|
*
|
|
* @returns the width of a character in pixels.
|
|
*/
|
|
double textbox_get_estimated_char_width ( void );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Delete character before cursor.
|
|
*/
|
|
void textbox_cursor_bkspc ( textbox *tb );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Delete character after cursor.
|
|
*/
|
|
void textbox_cursor_del ( textbox *tb );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Move cursor one position backward.
|
|
*/
|
|
void textbox_cursor_dec ( textbox *tb );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Move cursor one position forward.
|
|
*/
|
|
void textbox_cursor_inc ( textbox *tb );
|
|
|
|
/**
|
|
* @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 );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
* @param x The new horizontal position to place with textbox
|
|
* @param y The new vertical position to place with textbox
|
|
* @param w The new width of the textbox
|
|
* @param h The new height of the textbox
|
|
*
|
|
* Move and resize the textbox.
|
|
* @TODO remove for #widget_resize and #widget_move
|
|
*/
|
|
void textbox_moveresize ( textbox *tb, int x, int y, int w, int h );
|
|
/**
|
|
* Get the (estimated) with of a character, can be used to calculate window width.
|
|
*
|
|
* @returns the estimated width of a character.
|
|
*/
|
|
int textbox_get_estimated_char_height ( void );
|
|
/**
|
|
* @param p The new default PangoContext
|
|
*
|
|
* Set the default pango context (with font description) for all textboxes.
|
|
*/
|
|
void textbox_set_pango_context ( PangoContext *p );
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
* @param list New pango attributes
|
|
*
|
|
* Sets #list as active pango attributes.
|
|
*/
|
|
void textbox_set_pango_attributes ( textbox *tb, PangoAttrList *list );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* Get the list of currently active pango attributes.
|
|
*
|
|
* @returns the pango attributes
|
|
*/
|
|
PangoAttrList *textbox_get_pango_attributes ( textbox *tb );
|
|
|
|
/**
|
|
* @param tb Handle to the textbox
|
|
*
|
|
* @returns the visible text.
|
|
*/
|
|
const char *textbox_get_visible_text ( const textbox *tb );
|
|
/*@}*/
|
|
#endif //ROFI_TEXTBOX_H
|