ui/ui/tree.h

/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2017 Olaf Wintermann. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 *   1. Redistributions of source code must retain the above copyright
 *      notice, this list of conditions and the following disclaimer.
 *
 *   2. Redistributions in binary form must reproduce the above copyright
 *      notice, this list of conditions and the following disclaimer in the
 *      documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef UI_TREE_H
#define	UI_TREE_H

#include "toolkit.h"

#ifdef	__cplusplus
extern "C" {
#endif

typedef struct UiModel         UiModel;
typedef struct UiListCallbacks UiListCallbacks;
typedef struct UiListSelection UiListSelection;

typedef struct UiListArgs      UiListArgs;

typedef enum UiModelType {
    UI_STRING = 0,
    UI_INTEGER,
    UI_ICON,
    UI_ICON_TEXT,
} UiModelType;

struct UiModel {
    /*
     * number of columns
     */
    int columns;
    
    /*
     * array of column types
     * array length is the number of columns
     */
    UiModelType *types;
    
    /*
     * array of column titles
     * array length is the number of columns
     */
    char **titles;
    
    /*
     * function for translating model data to view data
     * first argument is the pointer returned by UiList->get or UiTree->get
     * second argument is the column index
     * TODO: return
     */
    void*(*getvalue)(void*, int);
    
    UiBool(*candrop)(UiEvent*, UiSelection*, UiList*, int);
    void(*drop)(UiEvent*, UiSelection*, UiList*, int);
    UiBool(*candrag)(UiEvent*, UiList*, int);
    void(*data_get)(UiEvent*, UiSelection*, UiList*, int);
    void(*data_delete)(UiEvent*, UiList*, int);
};

struct UiListCallbacks {
    /*
     * selection callback
     */
    ui_callback activate;
    
    /*
     * cursor callback
     */
    ui_callback selection;
    
    /*
     * userdata for all callbacks
     */
    void *userdata;
};

struct UiListSelection {
    /*
     * number of selected items
     */
    int count;
    
    /*
     * indices of selected rows
     */
    int *rows;
};

struct UiListArgs {
    UiTri fill;
    UiBool hexpand;
    UiBool vexpand;
    int colspan;
    int rowspan;

    UiList* list;
    const char* varname;
    UiModel* model;
    ui_getvaluefunc getvalue;
    ui_callback onactivate;
    void* onactivatedata;
    ui_callback onselection;
    void* onselectiondata;
    UiBool multiselection;
};

UiModel* ui_model(UiContext *ctx, ...);
void ui_model_free(UiContext *ctx, UiModel *mi);

#define ui_listview(obj, ...) ui_listview_create(obj, (UiListArgs) { __VA_ARGS__ } )
#define ui_table(obj, ...) ui_table_create(obj, (UiListArgs) { __VA_ARGS__ } )
#define ui_combobox(obj, ...) ui_combobox_create(obj, (UiListArgs) { __VA_ARGS__ } )

UIWIDGET ui_listview_create(UiObject* obj, UiListArgs args);
UIWIDGET ui_table_create(UiObject* obj, UiListArgs args);
UIWIDGET ui_combobox_create(UiObject* obj, UiListArgs);

UIWIDGET ui_listview_deprecated(UiObject *obj, UiList *list, ui_getvaluefunc getvalue, ui_callback f, void *udata);
UIWIDGET ui_listview_str_deprecated(UiObject *obj, UiList *list, ui_callback f, void *udata);
UIWIDGET ui_listview_nv_deprecated(UiObject *obj, char *listname, ui_getvaluefunc getvalue, ui_callback f, void *udata);

UIWIDGET ui_table_deprecated(UiObject *obj, UiList *data, UiModel *model, UiListCallbacks cb);
UIWIDGET ui_table_nv_deprecated(UiObject *obj, char *varname, UiModel *model, UiListCallbacks cb);

void ui_table_dragsource(UIWIDGET tablewidget, int actions, char *target0, ...);
void ui_table_dragsource_a(UIWIDGET tablewidget, int actions, char **targets, int nelm);
void ui_table_dragdest(UIWIDGET tablewidget, int actions, char *target0, ...);
void ui_table_dragdest_a(UIWIDGET tablewidget, int actions, char **targets, int nelm);

UIWIDGET ui_combobox_deprecated(UiObject *obj, UiList *list, ui_getvaluefunc getvalue, ui_callback f, void *udata);
UIWIDGET ui_combobox_str_deprecated(UiObject *obj, UiList *list, ui_callback f, void *udata);
UIWIDGET ui_combobox_nv_deprecated(UiObject *obj, char *varname, ui_getvaluefunc getvalue, ui_callback f, void *udata);

#ifdef	__cplusplus
}
#endif

#endif	/* UI_TREE_H */