██      ██ ██████  ███████ ███████ 
██      ██ ██   ██ ██      ██      
██      ██ ██████  ███████ █████   
██      ██ ██   ██      ██ ██      
███████ ██ ██████  ███████ ██  
                                                                           

Manual da Biblioteca libsf

Estruturas de Dados

t_root

typedef struct s_root
{
	GtkWidget *window;
	GtkWidget *fixed;
	GtkWidget *item;
	int x;
	int y;
	int th;
}	t_root;

typedef struct s_window_manager
{
	GtkWidget *main_window;         // Janela principal
	GtkWidget *settings_window;     // Janela de configurações
	GtkWidget *content_window;      // Janela de conteúdo
	GtkWidget *dialog_window;       // Janela de diálogo
	GtkWidget *tools_window;        // Janela de ferramentas
	GtkWidget *help_window;         // Janela de ajuda
	GtkWidget *temp_window;         // Janela temporária
	GtkWidget *fixed_layout_window; // Janela com layout fixo
	GtkWidget *grid_layout_window;  // Janela com layout em grid
	GtkWidget *data_window;         // Janela com dados
	GtkWidget *preview_window;      // Janela de visualização
}	t_window_manager;
``
Esta estrutura é usada para armazenar referências a widgets GTK e posições no layout fixo.

### `t_key_event_data`
```c
typedef struct
{
	void (*key_handler)(GdkEventKey *event, gpointer user_data);
	gpointer user_data;
}	t_key_event_data;

Estrutura para associar um manipulador de eventos de teclado e dados de usuário.

t_mouse_event_data

typedef struct
{
	void (*mouse_handler)(GdkEventButton *event, gpointer user_data);
	gpointer user_data;
}	t_mouse_event_data;

Estrutura para associar um manipulador de eventos de mouse e dados de usuário.

t_loop_event_data

typedef struct
{
	void (*loop_handler)(gpointer user_data);
	gpointer user_data;
}	t_loop_event_data;

Estrutura para associar um manipulador de eventos de loop e dados de usuário.

Funções

Criação de Janelas e Layouts

• GtkWidget *create_window_s(const char *title, int width, int height);

  • Cria uma janela com o título especificado e dimensões dadas.

• GtkWidget *add_fixed_layout_to_window(GtkWidget *window);

  • Adiciona um layout fixo à janela especificada.

Adicionando Widgets

• GtkWidget *add_button(GtkWidget *container, const char *label, int x, int y, GCallback callback);

  • Adiciona um botão ao contêiner especificado na posição (x, y) com um rótulo e um callback.

• GtkWidget *add_label(GtkWidget *container, const char *text, int x, int y);

  • Adiciona um rótulo ao contêiner na posição (x, y).

• GtkWidget *add_entry(GtkWidget *container, int x, int y, GCallback callback);

  • Adiciona uma caixa de entrada no contêiner na posição (x, y) com um callback.

• GtkWidget *add_color_chooser(GtkWidget *container, int x, int y, GCallback callback);

  • Adiciona um seletor de cores ao contêiner na posição (x, y).

• GtkWidget *add_drawing_area(GtkWidget *container, int x, int y, int width, int height, GCallback draw_callback);

  • Adiciona uma área de desenho ao contêiner na posição e dimensões especificadas.

• GtkWidget *add_file_chooser(GtkWidget *container, int x, int y, GCallback callback);

  • Adiciona um seletor de arquivos ao contêiner na posição (x, y).

• GtkWidget *add_image(GtkWidget *container, const char *file_path, int x, int y);

  • Adiciona uma imagem ao contêiner na posição (x, y).

• GtkWidget *add_separator(GtkWidget *container, int x, int y, gboolean horizontal);

  • Adiciona um separador (horizontal ou vertical) ao contêiner.

• void add_tabs(GtkWidget *notebook, GtkWidget **pages, const char **titles, int count);

  • Adiciona várias abas ao notebook, com páginas e títulos especificados.

• GtkWidget *add_volume_slider(GtkWidget *container, int x, int y, GCallback callback);

  • Adiciona um controle deslizante de volume ao contêiner na posição (x, y).

• GtkWidget *add_checkbox(GtkWidget *container, const char *label, int x, int y, GCallback callback);

Criação de Widgets com Posição

• GtkWidget *create_image_with_position(GtkWidget *container, const char *file_path, int x, int y, int width, int height);

  • Cria uma imagem com posição e dimensões especificadas.

• GtkWidget *create_scale_with_position(GtkWidget *container, int x, int y, int min, int max, int step);

  • Cria um controle deslizante com valores mínimos, máximos e passo especificados.

• GtkWidget *create_checkbox_with_position(GtkWidget *container, const char *label, int x, int y, gboolean active);

  • Cria uma caixa de seleção com um estado inicial especificado.

• GtkWidget *create_drawing_area_with_position(GtkWidget *container, int x, int y, int width, int height, gboolean (*draw_callback)(GtkWidget *, cairo_t *, gpointer), gpointer data);

  • Cria uma área de desenho com callback de desenho especificado.

• GtkWidget *create_label_with_position(GtkWidget *container, const char *text, int x, int y, const GdkRGBA *color);

  • Cria um rótulo com cor e posição especificadas.

• GtkWidget *create_button_with_position(GtkWidget *container, const char *label, int x, int y, void (*callback)(GtkWidget *, gpointer), gpointer data);

  • Cria um botão com posição e callback especificados.

Criação de Widgets

• GtkWidget *create_check_button(const char *label, gboolean initial_state);

  • Cria um botão de verificação com um estado inicial.

• GtkWidget *create_progress_bar(double initial_fraction);

  • Cria uma barra de progresso com uma fração inicial.

• GtkWidget *create_spin_button(double min, double max, double step, double initial_value);

  • Cria um botão giratório com valores mínimo, máximo e passo especificados.

• GtkWidget *create_combo_box(const char **items, int num_items, int default_index);

  • Cria uma caixa de combinação com itens especificados e um índice padrão.

• GtkWidget *create_image_ph(GtkWidget *container, const char *file_path, gint x, gint y, gint width, gint height);

  • Cria uma imagem com caminho de arquivo, posição e dimensões especificados.

• GtkWidget *create_vbox(gboolean homogeneous, gint spacing);

  • Cria uma caixa vertical com espaçamento especificado.

• GtkWidget *create_hbox(gboolean homogeneous, gint spacing);

  • Cria uma caixa horizontal com espaçamento especificado.

• GtkWidget *create_grid(gint row_spacing, gint column_spacing);

  • Cria uma grade com espaçamento entre linhas e colunas.

• GtkWidget *create_fixed_layout(void);

  • Cria um layout fixo.

• GtkWidget *create_entry1(GtkFixed *fixed, gint x, gint y, const char *border_color, void (*callback)(GtkEntry *, gpointer));

  • Cria uma entrada com cor da borda especificada.

• GtkWidget *create_label(GtkWidget *container, const char *text);

  • Cria um rótulo com texto especificado.

• GtkWidget *create_text_view(GtkWidget *container);

  • Cria uma área de texto.

Manipulação de Eventos

void loop_window(GtkWidget *window);

• Inicia o loop principal para a janela.

• void add_event(GtkWidget *widget, const char *event_name, GCallback callback);

  • Adiciona um evento a um widget com um callback.

• void add_to_fixed(GtkFixed *fixed, GtkWidget *widget, gint x, gint y);

  • Adiciona um widget a um layout fixo na posição especificada.

• void add_to_grid(GtkGrid *grid, GtkWidget *widget, guint left, guint top, guint width, guint height);

  • Adiciona um widget a uma grade na posição e dimensões especificadas.

• GtkWidget *new_window(const char *title, int width, int height);

  • Cria uma nova janela com título e dimensões especificadas.

• void apply_css(GtkWidget *widget, const char *css);

  • Aplica um estilo CSS a um widget.

• void set_button_color(GtkWidget *button, const char *color);

  • Define a cor de um botão.

• void set_label_color(GtkWidget *label, const char *color);

  • Define a cor de um rótulo.

• void set_entry_border_color(GtkWidget *entry, const char *color);

  • Define a cor da borda de uma entrada.

• void create_image(GtkFixed *fixed, const char *file_path, gint x, gint y);

  • Cria uma imagem em um layout fixo.

• void create_entry(GtkFixed *fixed, gint x, gint y);

  • Cria uma entrada em um layout fixo.

• void create_text(GtkFixed *fixed, const char *text, gint x, gint y);

  • Cria um texto em um layout fixo.

• void create_button(GtkFixed *fixed, const char *label, gint x, gint y, void (*callback)(GtkWidget *, gpointer), gpointer user_data);

  • Cria um botão em um layout fixo com callback.

• void show_notification(GtkWidget *parent, const char *title, const char *message);

Criação de Menus e Outros

• GtkWidget *create_image_c(GtkWidget *container, const char *file_path);

  • Cria uma imagem em um contêiner.

• GtkWidget *create_calendar(GtkWidget *container);

  • Cria um calendário em um contêiner.

• GtkWidget *create_file_chooser_button(GtkWidget *container, const char *title, GtkFileChooserAction action, GCallback callback, gpointer data);

  • Cria um botão de seletor de arquivos.

• GtkWidget *create_color_chooser(GtkWidget *container, GCallback callback, gpointer data);

  • Cria um seletor de cores em um contêiner.

• GtkWidget *create_notebook(GtkWidget *container);

  • Cria um notebook em um contêiner.

• void add_tab_to_notebook(GtkWidget *notebook, const char *label, GtkWidget *content);

  • Adiciona uma aba ao notebook com rótulo e conteúdo.

• GtkWidget *create_media_viewer(GtkWidget *container);

  • Cria um visualizador de mídia em um contêiner.

• void set_status_bar_message(GtkWidget *status_bar, const char *message);

  • Define a mensagem da barra de status.

• GtkWidget *create_toolbar(GtkWidget *container);

  • Cria uma barra de ferramentas em um contêiner.

• **`GtkToolItem *create_toolbar_button(GtkWidget *toolbar, const char *icon_name, const char *tooltip, GCallback callback, gpointer d