rofi/include/mode.h

253 lines
6.6 KiB
C
Raw Normal View History

/*
* rofi
*
* MIT/X11 License
2021-06-09 12:50:39 +00:00
* Copyright © 2013-2021 Qball Cow <qball@gmpclient.org>
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the
* "Software"), to deal in the Software without restriction, including
* without limitation the rights to use, copy, modify, merge, publish,
* distribute, sublicense, and/or sell copies of the Software, and to
* permit persons to whom the Software is furnished to do so, subject to
* the following conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
*/
2016-01-07 18:47:37 +00:00
#ifndef ROFI_MODE_H
#define ROFI_MODE_H
#include "rofi-types.h"
#include <cairo.h>
G_BEGIN_DECLS
2016-01-07 18:47:37 +00:00
/**
* @defgroup MODE Mode
*
* The 'object' that makes a mode in rofi.
* @{
*/
2016-11-15 07:24:06 +00:00
/**
* Type of a mode.
2016-11-15 07:24:27 +00:00
* Access should be done via mode_* functions.
2016-11-15 07:24:06 +00:00
*/
typedef struct rofi_mode Mode;
2016-01-07 18:47:37 +00:00
/**
* Enum used to sum the possible states of ROFI.
*/
typedef enum {
/** Exit. */
MODE_EXIT = 1000,
/** Skip to the next cycle-able dialog. */
NEXT_DIALOG = 1001,
/** Reload current DIALOG */
RELOAD_DIALOG = 1002,
/** Previous dialog */
PREVIOUS_DIALOG = 1003,
/** Reloads the dialog and unset user input */
RESET_DIALOG = 1004,
2016-01-07 18:47:37 +00:00
} ModeMode;
/**
* State returned by the rofi window.
*/
typedef enum {
/** Entry is selected. */
MENU_OK = 0x00010000,
/** User canceled the operation. (e.g. pressed escape) */
MENU_CANCEL = 0x00020000,
/** User requested a mode switch */
MENU_NEXT = 0x00040000,
/** Custom (non-matched) input was entered. */
MENU_CUSTOM_INPUT = 0x00080000,
/** User wanted to delete entry from history. */
MENU_ENTRY_DELETE = 0x00100000,
/** User wants to jump to another switcher. */
MENU_QUICK_SWITCH = 0x00200000,
/** User wants to jump to custom command. */
MENU_CUSTOM_COMMAND = 0x00800000,
/** Go to the previous menu. */
MENU_PREVIOUS = 0x00400000,
/** Go to the complete. */
MENU_COMPLETE = 0x01000000,
/** Bindings specifics */
MENU_CUSTOM_ACTION = 0x10000000,
/** Mask */
MENU_LOWER_MASK = 0x0000FFFF
2016-01-07 18:47:37 +00:00
} MenuReturn;
/**
* @param mode The mode to initialize
*
* Initialize mode
*
* @returns FALSE if there was a failure, TRUE if successful
2016-01-07 18:47:37 +00:00
*/
int mode_init(Mode *mode);
2016-01-07 18:47:37 +00:00
/**
* @param mode The mode to destroy
*
* Destroy the mode
*/
void mode_destroy(Mode *mode);
2016-01-07 18:47:37 +00:00
/**
2017-04-23 13:17:15 +00:00
* @param mode The mode to query
2016-01-07 18:47:37 +00:00
*
* Get the number of entries in the mode.
*
2018-05-14 13:46:34 +00:00
* @returns an unsigned int with the number of entries.
2016-01-07 18:47:37 +00:00
*/
unsigned int mode_get_num_entries(const Mode *mode);
2016-01-07 18:47:37 +00:00
/**
* @param mode The mode to query
* @param selected_line The entry to query
* @param state The state of the entry [out]
* @param attribute_list List of extra (pango) attribute to apply when
* displaying. [out][null]
2016-01-07 18:47:37 +00:00
* @param get_entry If the should be returned.
*
* Returns the string as it should be displayed for the entry and the state of
* how it should be displayed.
2016-01-07 18:47:37 +00:00
*
* @returns allocated new string and state when get_entry is TRUE otherwise just
* the state.
2016-01-07 18:47:37 +00:00
*/
char *mode_get_display_value(const Mode *mode, unsigned int selected_line,
int *state, GList **attribute_list, int get_entry);
2016-01-07 20:27:20 +00:00
2017-04-12 15:58:32 +00:00
/**
* @param mode The mode to query
* @param selected_line The entry to query
2017-06-03 14:27:11 +00:00
* @param height The desired height of the icon.
2017-04-12 15:58:32 +00:00
*
* Returns the icon for the selected_line
*
* @returns allocated new cairo_surface_t if applicable
*/
cairo_surface_t *mode_get_icon(const Mode *mode, unsigned int selected_line,
int height);
2017-04-12 15:58:32 +00:00
2016-01-07 20:27:20 +00:00
/**
* @param mode The mode to query
* @param selected_line The entry to query
*
* Return a string that can be used for completion. It has should have no
* markup.
2016-01-07 20:27:20 +00:00
*
* @returns allocated string.
*/
char *mode_get_completion(const Mode *mode, unsigned int selected_line);
2016-01-07 20:27:20 +00:00
/**
2016-01-08 08:29:15 +00:00
* @param mode The mode to query
2016-07-29 06:32:34 +00:00
* @param menu_retv The menu return value.
* @param input Pointer to the user input string. [in][out]
2016-01-07 20:27:20 +00:00
* @param selected_line the line selected by the user.
*
* Acts on the user interaction.
*
* @returns the next #ModeMode.
*/
ModeMode mode_result(Mode *mode, int menu_retv, char **input,
unsigned int selected_line);
2016-01-07 20:27:20 +00:00
/**
2016-01-08 08:29:15 +00:00
* @param mode The mode to query
2016-01-07 20:27:20 +00:00
* @param tokens The set of tokens to match against
* @param selected_line The index of the entry to match
*
* Match entry against the set of tokens.
*
* @returns TRUE if matches
*/
int mode_token_match(const Mode *mode, rofi_int_matcher **tokens,
unsigned int selected_line);
2016-01-07 20:27:20 +00:00
/**
2016-01-08 08:29:15 +00:00
* @param mode The mode to query
2016-01-07 20:27:20 +00:00
*
* Get the name of the mode.
*
* @returns the name of the mode.
*/
const char *mode_get_name(const Mode *mode);
2016-01-07 20:27:20 +00:00
/**
2016-01-08 08:29:15 +00:00
* @param mode The mode to query
2016-01-07 20:27:20 +00:00
*
* Free the resources allocated for this mode.
*/
void mode_free(Mode **mode);
2016-01-07 20:27:20 +00:00
2016-01-08 08:29:15 +00:00
/**
* @param mode The mode to query
*
* Helper functions for mode.
* Get the private data object.
*/
void *mode_get_private_data(const Mode *mode);
2016-01-08 08:29:15 +00:00
/**
* @param mode The mode to query
2016-07-29 06:32:34 +00:00
* @param pd Pointer to private data to attach to the mode.
2016-01-08 08:29:15 +00:00
*
* Helper functions for mode.
* Set the private data object.
*/
void mode_set_private_data(Mode *mode, void *pd);
2016-11-15 07:24:06 +00:00
/**
* @param mode The mode to query
*
* Get the name of the mode as it should be presented to the user.
*
* @return the user visible name of the mode
*/
const char *mode_get_display_name(const Mode *mode);
2016-11-15 07:24:06 +00:00
/**
* @param mode The mode to query
*
* Should be called once for each mode. This adds the display-name configuration
* option for the mode.
2016-11-15 07:24:06 +00:00
*/
void mode_set_config(Mode *mode);
2016-11-15 07:24:06 +00:00
/**
* @param mode The mode to query
2016-11-15 20:54:31 +00:00
* @param input The input to process
2016-11-15 07:24:06 +00:00
*
* This processes the input so it can be used for matching and sorting.
* This includes removing pango markup.
*
* @returns a newly allocated string
*/
char *mode_preprocess_input(Mode *mode, const char *input);
/**
* @param mode The mode to query
*
* Query the mode for a user display.
*
* @return a new allocated (valid pango markup) message to display (user should
* free).
*/
char *mode_get_message(const Mode *mode);
2020-10-12 19:39:36 +00:00
/**@}*/
G_END_DECLS
2016-01-07 18:47:37 +00:00
#endif