Manual de usuario de calibre, Publicación 2.73.0
Complementos de preferencias
class calibre.customize.PreferencesPlugin(plugin_path)
Clases base: calibre.customize.Plugin (página 211)
Un complemento que representa un widget mostrado en el cuadro de diálogo Preferencias.
Este complemento posee un solo método importante: create_widget(). Los diversos campos de este complemento controlan cómo se categoriza en la interfaz de usuario.
config_widget = None
Importa el camino al módulo que contiene una clase llamada ConfigWidget que implementa la ConfigWidgetInterface. Utilizado por create_widget().
category_order = 100
Donde debe estar la :attr: category de este complemento en la lista de categorías.
name_order = 100
Dónde debe estar el :attr: gui_name de este complemento en la lista de nombres.
category = None
La categoría en la que debe estar este complemento
gui_category = None
El nombre de categoría mostrado al usuario para este complemento
gui_name = None
El nombre que se muestra al usuario para este complemento
icon = None
El icono para este complemento, debe ser una ruta de acceso absoluta
description = None
La descripción usada para ayudas de herramientas y similares
create_widget(parent=None)
Crea y devuelve el widget Qt real usado para establecer este grupo de preferencias. El widget debe implementar calibre.gui2.preferences.ConfigWidgetInterface (página 234).
La implementación predeterminada usa config_widget para crear el widget.
class calibre.gui2.preferences.ConfigWidgetInterface
Esta clase define la interfaz que deben implementar todos los widgets mostrados en el cuadro de diálogo Preferencias. Ver ConfigWidgetBase para una clase base que implementa esta interfaz y también define varios
métodos prácticos.
changed_signal = None
Esta señal debe emitirse cuando el usuario cambia un valor en este widget
supports_restoring_to_defaults = True
Es True si y sólo si el método restore_to_defaults() está implementado.
restore_defaults_desc = u’Restablecer las configuraciones a sus valores predeterminados. Debe pulsar \xabAplicar
La ayuda de herramienta para el botón de restauración de los valores predeterminados
restart_critical = False
Si es True el diálogo de preferencias no permitirá al usuario introducir más preferencias. Sólo tiene efecto
si commit() devuelve True.
genesis(gui)
Se ejecuta una vez antes de mostrar el widget, debe realizar cualquier configuración necesaria.
Parámetros gui – La interfaz gráfica principal de calibre
234
Capítulo 1. Secciones