Extensiones de interfaz y vista previa

Visualización de resultados

ISidebarFilterProvider

Añade grupos de filtro de categorización a la barra lateral de resultados (por ejemplo, franjas por fecha o por tamaño).

interface ISidebarFilterProvider
{
    int SortOrder { get; } // default 100; lower renders first
    IEnumerable<SidebarFilterGroup> GetFilterGroups();
}

SidebarFilterGroup tiene un Header, un indicador AllowMultiSelect (false por defecto; permite que el grupo seleccione más de un elemento a la vez, combinados con OR — déjalo desactivado para elementos cuyo significado solo tiene sentido de uno en uno, por ejemplo rangos de fechas superpuestos/acumulativos), y una lista de SidebarFilterItem (Id, DisplayName, icono opcional, y un FilterPredicate asíncrono opcional sobre la lista de resultados actual). El host muestra un botón para limpiar en un grupo en cuanto tiene una selección, así que un proveedor no necesita un pseudo-elemento "Todos"/"Cualquiera" propio.

IResultColumnProvider

Inyecta columnas adicionales en la vista de cuadrícula de resultados (tamaño de archivo, fecha de modificación, metadatos personalizados, ...).

interface IResultColumnProvider
{
    IEnumerable<ResultColumnDefinition> GetColumns();
    string GetCellValue(ISearchResult result, string columnId);
}

ResultColumnDefinition lleva un id de columna, texto de cabecera, ancho, y delegados opcionales VisibilityPredicate/SortComparer.

Panel Rápido

IQuickPanelTabProvider

Aporta una pestaña entera al Panel Rápido, el panel flotante acoplado sobre la ventana que esté en primer plano. La pestaña lleva el nombre del componente y contiene una lista, y el anfitrión dibuja las entradas con sus propias filas de resultados, así que iconos, apertura, miniaturas y menú de acciones vienen gratis. CoreExtensions trae cinco: Favoritos, Historial, Elementos recientes de Windows, Última carpeta y Archivos recientes.

interface IQuickPanelTabProvider : IPluginComponent
{
    Task<IReadOnlyList<ISearchResult>> GetEntriesAsync(CancellationToken cancellationToken = default);
}

Una pestaña, y no un grupo dentro de la pestaña de otro: lo que devuelve un proveedor es una colección entera, ortogonal a las carpetas que reúne un espacio de trabajo, así que se coloca junto a ellas en lugar de tener que marcarse dentro de cada una.

GetEntriesAsync() se llama cada vez que se invoca el panel, y devuelve un conjunto terminado en lugar de transmitirlo: el panel ordena y recorta las entradas como conjunto (lo más nuevo primero, como mucho tantas), así que no puede mostrar la mitad sin reordenar en cada llegada. Eso no cuesta latencia — cada pestaña se carga en su propia tarea y el panel se abre con la primera que llega, así que un proveedor que tiene que ir a buscar solo retrasa su propia pestaña. Respeta el token igualmente: se cancela cuando el panel se cierra.

Rellena el Modified de ISearchResult.Metadata cuando la fuente conozca uno — el orden por defecto de lo más nuevo primero lo usa, y las entradas sin él conservan el orden en que las devolviste. Un proveedor que no devuelve nada no llega a tener pestaña, y uno que lanza una excepción cuesta su propia pestaña y nada más.

La pestaña se abre como miniaturas salvo que el usuario marque Mostrar como lista para ella en Ajustes → Panel Rápido → Pestañas de plugin; el conmutador del propio encabezado del panel la sigue anulando mientras esté abierto. Cerrar una pestaña con su × es deliberadamente distinto de deshabilitar el componente en Ajustes → Plugins: lo primero solo la saca de la franja (vuelve a marcarla en esa misma página), lo segundo impide que se cargue siquiera. El anfitrión usa el id del componente como clave estable tanto para el estado cerrado como para la elección de vista, así que una pestaña cerrada mientras su plugin estaba apagado sigue cerrada cuando vuelve.

Vista previa y miniaturas

IFilePreviewProvider

Renderiza un UIElement de WPF personalizado en el panel de vista previa QuickLook (ver Menú de acciones y vista previa) para los tipos de archivo que quieras tratar de forma especial.

interface IFilePreviewProvider
{
    string Name { get; }
    int Priority { get; } // default 0; higher runs first
    bool CanPreview(string path, bool isDir);
    UIElement CreatePreview(string path, bool isDir);
    bool RendersExternally { get; } // default false
}

Priority es solo el orden por defecto — el usuario puede reordenar libremente los proveedores (incluso en relación con el tuyo) desde Configuración → General → Vista previa y miniaturas, lo cual prevalece sobre lo que devuelva Priority. No des por hecho que la prioridad declarada por tu proveedor es el orden en el que realmente se ejecuta.

Dos interfaces complementarias opcionales refinan el comportamiento de la vista previa:

• IPreviewSessionAware — implementa esto en el propio proveedor de vista previa si retiene recursos costosos fuera de proceso (un manejador nativo alojado, un bloqueo de archivo); EndPreviewSession() se llama una vez termina toda la sesión de vista previa, no en cada cambio individual de vista previa. La única excepción: para un proveedor con RendersExternally en true, el host también lo llama en cada cambio desde ese proveedor, no solo al final de la sesión — ver más abajo.
• IReusablePreview — implementa esto en el UIElement devuelto por CreatePreview si puede reapuntarse a un nuevo archivo en lugar de reconstruirse desde cero: TrySetTarget(path, isDir) devuelve true si gestionó el cambio in situ, false para indicarle al host que construya una vista previa nueva en su lugar.

RendersExternally es para un proveedor cuya superficie de vista previa real es una ventana separada, gestionada externamente, en lugar del UIElement que devuelve CreatePreview — por ejemplo, entregar el archivo por completo a otra aplicación. Cuando el proveedor ganador tiene esto activado, el host oculta su propio panel de vista previa en lugar de mostrar el contenido de CreatePreview (que entonces nunca llega a mostrarse realmente, así que puede ser un marcador de posición trivial). Combínalo con IReceivesPreviewPanelBounds para obtener el rectángulo de pantalla exacto (en píxeles físicos) que habría ocupado el propio panel del host, de modo que la ventana externa pueda posicionarse ahí en lugar de donde aparecería de otro modo:

interface IReceivesPreviewPanelBounds
{
    void OnPreviewPanelBoundsAvailable(int left, int top, int width, int height);
}

Consulta el plugin (experimental) incluido QuickLook Bridge para ver un ejemplo real: detecta una aplicación externa QuickLook a través de su propia named pipe y, si está accesible, acopla la ventana de esa aplicación en el lugar del panel del host para cada archivo/carpeta — ver Menú de acciones y vista previa → Vista previa externa mediante QuickLook para el comportamiento de cara al usuario. Ten en cuenta que esto es algo distinto del propio panel de vista previa integrado de Lertaro, al que también se le llama informalmente "QuickLook" en todo este código y esta documentación.

IThumbnailProvider

Sobrescribe el icono/miniatura mostrado para los resultados que coincidan.

interface IThumbnailProvider : IPluginComponent
{
    int Priority { get; } // default 0; higher runs first
    bool CanProvideThumbnail(string path, bool isDir);
    ImageSource? GetThumbnail(string path, int size);
}

La misma advertencia que con IFilePreviewProvider.Priority de más arriba: es solo el orden por defecto, y el usuario puede sobrescribirlo desde Configuración → General → Vista previa y miniaturas (la misma pestaña aloja las listas de orden de ambos tipos de proveedor).

Temas y localización

IThemeProvider / ITheme

Registra uno o más diccionarios de recursos WPF personalizados como temas seleccionables (mostrados en Configuración → General → Tema de interfaz).

interface IThemeProvider
{
    string Name { get; }
    IEnumerable<ITheme> GetThemes();
}

interface ITheme
{
    string Id { get; }
    string DisplayName { get; }
    bool IsDark { get; }
    double WindowOpacity { get; } // default 1.0
    ResourceDictionary GetResources();
}

ITranslationProvider

Suministra cadenas de interfaz para una cultura determinada — para la interfaz propia del plugin, o (como con PinyinAlias) simplemente su propio nombre visible. Ver Plugins de ejemplo para un plugin que implementa esto junto a una interfaz no relacionada en la misma clase.

interface ITranslationProvider
{
    string Name { get; }
    IReadOnlyList<string> SupportedCultures { get; } // e.g. "zh-CN", "en-US"
    IReadOnlyDictionary<string, string> GetTranslations(string cultureName);
}

TranslationService.LoadEmbeddedTranslations (ver Servicios del host) es la forma estándar de respaldar esto con archivos JSON incrustados en la DLL de tu plugin.