/* Chrysalide - Outil d'analyse de fichiers binaires
* tweak.c - section d'éléments à paramétrer
*
* Copyright (C) 2025 Cyrille Bagard
*
* This file is part of Chrysalide.
*
* Chrysalide 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.
*
* Chrysalide 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 Chrysalide. If not, see .
*/
#include "tweak.h"
#include
#include
#include
#include "helpers.h"
#include "tweak-int.h"
/* Initialise la classe des sections d'éléments paramétrables. */
static void gtk_tweak_section_class_init(GtkTweakSectionClass *);
/* Initialise une instance de section d'éléments paramétrables. */
static void gtk_tweak_section_init(GtkTweakSection *);
/* Supprime toutes les références externes. */
static void gtk_tweak_section_dispose(GtkTweakSection *);
/* Procède à la libération totale de la mémoire. */
static void gtk_tweak_section_finalize(GtkTweakSection *);
/* Détermine le type du composant d'affichage générique. */
G_DEFINE_TYPE(GtkTweakSection, gtk_tweak_section, GTK_TYPE_LIST_BOX_ROW);
/******************************************************************************
* *
* Paramètres : class = classe GTK à initialiser. *
* *
* Description : Initialise la classe des sections d'éléments paramétrables. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void gtk_tweak_section_class_init(GtkTweakSectionClass *class)
{
GObjectClass *object; /* Plus haut niveau équivalent */
GtkWidgetClass *widget; /* Classe de haut niveau */
object = G_OBJECT_CLASS(class);
object->dispose = (GObjectFinalizeFunc/* ! */)gtk_tweak_section_dispose;
object->finalize = (GObjectFinalizeFunc)gtk_tweak_section_finalize;
widget = GTK_WIDGET_CLASS(class);
gtk_widget_class_set_template_from_resource(widget, "/re/chrysalide/framework/gtkext/tweak.ui");
gtk_widget_class_bind_template_child(widget, GtkTweakSection, icon);
gtk_widget_class_bind_template_child(widget, GtkTweakSection, label);
gtk_widget_class_bind_template_child(widget, GtkTweakSection, next);
}
/******************************************************************************
* *
* Paramètres : section = composant GTK à initialiser. *
* *
* Description : Initialise une instance de section d'éléments paramétrables. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void gtk_tweak_section_init(GtkTweakSection *section)
{
gtk_widget_init_template(GTK_WIDGET(section));
section->category = NULL;
section->sub = NULL;
section->has_sub_section = true;
}
/******************************************************************************
* *
* Paramètres : section = instance d'objet GLib à traiter. *
* *
* Description : Supprime toutes les références externes. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void gtk_tweak_section_dispose(GtkTweakSection *section)
{
gtk_widget_dispose_template(GTK_WIDGET(section), GTK_TYPE_TWEAK_SECTION);
G_OBJECT_CLASS(gtk_tweak_section_parent_class)->dispose(G_OBJECT(section));
}
/******************************************************************************
* *
* Paramètres : section = instance d'objet GLib à traiter. *
* *
* Description : Procède à la libération totale de la mémoire. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void gtk_tweak_section_finalize(GtkTweakSection *section)
{
if (section->category != NULL)
free(section->category);
if (section->has_sub_section && section->sub != NULL)
free(section->sub);
G_OBJECT_CLASS(gtk_tweak_section_parent_class)->finalize(G_OBJECT(section));
}
/******************************************************************************
* *
* Paramètres : info = informations associées à la section. *
* *
* Description : Crée une nouvelle section de configuration. *
* *
* Retour : Composant GTK mis en place. *
* *
* Remarques : - *
* *
******************************************************************************/
GtkTweakSection *gtk_tweak_section_new(const tweak_info_t *info)
{
GtkTweakSection *result; /* Instance à retourner */
result = g_object_new(GTK_TYPE_TWEAK_SECTION, NULL);
if (!gtk_tweak_section_create(result, info))
g_clear_object(&result);
return result;
}
/******************************************************************************
* *
* Paramètres : section = section à initialiser pleinement. *
* info = informations associées à la section. *
* *
* Description : Met en place une nouvelle section de configuration. *
* *
* Retour : Bilan de l'opération. *
* *
* Remarques : - *
* *
******************************************************************************/
bool gtk_tweak_section_create(GtkTweakSection *section, const tweak_info_t *info)
{
bool result; /* Bilan à retourner */
result = true;
gtk_image_set_from_icon_name(section->icon, info->image);
gtk_label_set_label(section->label, info->label);
gtk_widget_set_visible(section->next, info->has_sub_section);
section->category = strdup(info->category);
if (info->has_sub_section)
{
section->sub = strdup(info->sub);
section->has_sub_section = true;
}
else
{
section->panel = info->panel;
section->has_sub_section = false;
}
return result;
}
/******************************************************************************
* *
* Paramètres : section = section à consulter. *
* *
* Description : Fournit l'étiquette associée à une section de configuration. *
* *
* Retour : Désignation humaine de la section. *
* *
* Remarques : - *
* *
******************************************************************************/
const char *gtk_tweak_section_get_label(const GtkTweakSection *section)
{
const char *result; /* Texte à retourner */
result = gtk_label_get_text(section->label);
return result;
}
/******************************************************************************
* *
* Paramètres : section = section à consulter. *
* *
* Description : Indique si la section renvoie vers une sous-section. *
* *
* Retour : Bilan de la consultation. *
* *
* Remarques : - *
* *
******************************************************************************/
bool gtk_tweak_section_has_sub_section(const GtkTweakSection *section)
{
bool result; /* Statut à retourner */
result = section->has_sub_section;
return result;
}
/******************************************************************************
* *
* Paramètres : section = section à consulter. *
* *
* Description : Fournit le type d'un éventuel panneau de configuration lié. *
* *
* Retour : Bilan de la consultation. *
* *
* Remarques : - *
* *
******************************************************************************/
GType gtk_tweak_section_get_panel(const GtkTweakSection *section)
{
GType result; /* Type d'objet à retourner */
assert(!section->has_sub_section);
result = section->panel;
return result;
}
/******************************************************************************
* *
* Paramètres : section = section à consulter. *
* *
* Description : Fournit la désignation d'une éventuelle sous-section liée. *
* *
* Retour : Désignation associée à la sous-section. *
* *
* Remarques : - *
* *
******************************************************************************/
const char *gtk_tweak_section_get_sub_section(const GtkTweakSection *section)
{
const char *result; /* Désignation à renvoyer */
assert(section->has_sub_section);
result = section->sub;
return result;
}