dialog.c

Go to the documentation of this file.

/***************************************************************************
    begin       : Wed Jan 20 2010
    copyright   : (C) 2019 by Martin Preuss
    email       : martin@libchipcard.de
 
 ***************************************************************************
 *                                                                         *
 *   This library is free software; you can redistribute it and/or         *
 *   modify it under the terms of the GNU Lesser General Public            *
 *   License as published by the Free Software Foundation; either          *
 *   version 2.1 of the License, or (at your option) any later version.    *
 *                                                                         *
 *   This library 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     *
 *   Lesser General Public License for more details.                       *
 *                                                                         *
 *   You should have received a copy of the GNU Lesser General Public      *
 *   License along with this library; if not, write to the Free Software   *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 *                                                                         *
 ***************************************************************************/
 
 
#ifdef HAVE_CONFIG_H
# include <config.h>
#endif
 
#define DISABLE_DEBUGLOG
 
 
#include "dialog_p.h"
#include "widget_l.h"
#include "gui_l.h"
 
#include <gwenhywfar/text.h>
#include <gwenhywfar/pathmanager.h>
#include <gwenhywfar/debug.h>
#include <gwenhywfar/i18n.h>
 
#include <assert.h>
#include <ctype.h>
#include <strings.h>
 
 
GWEN_INHERIT_FUNCTIONS(GWEN_DIALOG)
GWEN_LIST_FUNCTIONS(GWEN_DIALOG, GWEN_Dialog)
GWEN_LIST2_FUNCTIONS(GWEN_DIALOG, GWEN_Dialog)
 
 
 
 
GWEN_DIALOG *GWEN_Dialog_new(const char *dialogId)
{
  GWEN_DIALOG *dlg;
  int rv;
  GWEN_DB_NODE *db=NULL;
 
  GWEN_NEW_OBJECT(GWEN_DIALOG, dlg);
  dlg->refCount=1;
  GWEN_INHERIT_INIT(GWEN_DIALOG, dlg);
  GWEN_LIST_INIT(GWEN_DIALOG, dlg);
 
  if (dialogId && *dialogId)
    dlg->dialogId=strdup(dialogId);
 
  dlg->i18nDomain=strdup(PACKAGE);
 
  dlg->widgets=GWEN_Widget_Tree_new();
 
  dlg->subDialogs=GWEN_Dialog_List_new();
 
  /* try to load preferences */
  rv=GWEN_Gui_ReadDialogPrefs(dialogId, NULL, &db);
  if (rv<0) {
    DBG_WARN(GWEN_LOGDOMAIN, "Could not read dialog preferences (%d)", rv);
    dlg->dbPreferences=GWEN_DB_Group_new("preferences");
  }
  else {
    dlg->dbPreferences=db;
  }
  dlg->mediaPaths=GWEN_StringList_new();
 
  return dlg;
}
 
 
 
GWEN_DIALOG *GWEN_Dialog_CreateAndLoadWithPath(const char *dialogId,
                                               const char *pmLibName,
                                               const char *pmDataDir,
                                               const char *fileName)
{
  GWEN_DIALOG *dlg;
  GWEN_BUFFER *fbuf;
  int rv;
 
  assert(dialogId);
  assert(pmLibName);
  assert(pmDataDir);
  assert(fileName);
 
  dlg=GWEN_Dialog_new(dialogId);
  if (dlg==NULL) {
    DBG_ERROR(GWEN_LOGDOMAIN, "Could not create dialog");
    return NULL;
  }
 
  /* get path of dialog description file */
  fbuf=GWEN_Buffer_new(0, 256, 0, 1);
  rv=GWEN_PathManager_FindFile(pmLibName, pmDataDir, fileName, fbuf);
  if (rv<0) {
    DBG_ERROR(GWEN_LOGDOMAIN, "Dialog description file not found (%d).", rv);
    GWEN_Buffer_free(fbuf);
    GWEN_Dialog_free(dlg);
    return NULL;
  }
 
  /* read dialog from dialog description file */
  rv=GWEN_Dialog_ReadXmlFile(dlg, GWEN_Buffer_GetStart(fbuf));
  if (rv<0) {
    DBG_INFO(GWEN_LOGDOMAIN, "here (%d).", rv);
    GWEN_Buffer_free(fbuf);
    GWEN_Dialog_free(dlg);
    return NULL;
  }
  DBG_INFO(GWEN_LOGDOMAIN, "Dialog \"%s\" loaded from \"%s\"", dialogId, GWEN_Buffer_GetStart(fbuf));
  GWEN_Buffer_free(fbuf);
 
  return dlg;
}
 
 
 
 
void GWEN_Dialog_free(GWEN_DIALOG *dlg)
{
  if (dlg) {
    assert(dlg->refCount);
 
    if (dlg->refCount>1) {
      dlg->refCount--;
    }
    else {
      int rv;
 
      /* try to save preferences */
      rv=GWEN_Gui_WriteDialogPrefs(dlg->dialogId, dlg->dbPreferences);
      if (rv<0) {
        DBG_WARN(GWEN_LOGDOMAIN, "Could not write dialog preferences (%d)", rv);
      }
 
      GWEN_INHERIT_FINI(GWEN_DIALOG, dlg);
      GWEN_LIST_FINI(GWEN_DIALOG, dlg);
      GWEN_Widget_Tree_free(dlg->widgets);
      free(dlg->dialogId);
      free(dlg->i18nDomain);
      dlg->refCount=0;
      GWEN_Dialog_List_free(dlg->subDialogs);
 
      GWEN_DB_Group_free(dlg->dbPreferences);
      GWEN_StringList_free(dlg->mediaPaths);
 
      GWEN_FREE_OBJECT(dlg);
    }
  }
}
 
 
 
GWEN_DIALOG *GWEN_Dialog_GetParentDialog(const GWEN_DIALOG *dlg)
{
  assert(dlg);
  assert(dlg->refCount);
 
  return dlg->parentDialog;
}
 
 
 
const char *GWEN_Dialog_GetId(const GWEN_DIALOG *dlg)
{
  assert(dlg);
  assert(dlg->refCount);
 
  return dlg->dialogId;
}
 
 
 
uint32_t GWEN_Dialog_GetGuiId(const GWEN_DIALOG *dlg)
{
  assert(dlg);
  assert(dlg->refCount);
 
  return dlg->guiId;
}
 
 
 
void GWEN_Dialog_SetGuiId(GWEN_DIALOG *dlg, uint32_t guiid)
{
  assert(dlg);
  assert(dlg->refCount);
 
  dlg->guiId=guiid;
}
 
 
 
void GWEN_Dialog_SetI18nDomain(GWEN_DIALOG *dlg, const char *s)
{
  assert(dlg);
  assert(dlg->refCount);
 
  free(dlg->i18nDomain);
  if (s)
    dlg->i18nDomain=strdup(s);
  else
    dlg->i18nDomain=strdup(PACKAGE);
}
 
 
 
const char *GWEN_Dialog_GetI18nDomain(const GWEN_DIALOG *dlg)
{
  assert(dlg);
  assert(dlg->refCount);
 
  return dlg->i18nDomain;
}
 
 
 
const char *GWEN_Dialog_TranslateString(const GWEN_DIALOG *dlg, const char *s)
{
  assert(dlg);
  assert(dlg->refCount);
 
  return GWEN_I18N_Translate(dlg->i18nDomain, s);
}
 
 
 
void GWEN_Dialog_AddMediaPath(GWEN_DIALOG *dlg, const char *s)
{
  assert(dlg);
  assert(dlg->refCount);
 
  GWEN_StringList_AppendString(dlg->mediaPaths, s, 0, 1);
}
 
 
 
void GWEN_Dialog_AddMediaPathsFromPathManager(GWEN_DIALOG *dlg,
                                              const char *destlib,
                                              const char *pathName,
                                              const char *relPath)
{
  GWEN_STRINGLIST *sl;
 
  sl=GWEN_PathManager_GetPaths(destlib, pathName);
  if (sl) {
    GWEN_STRINGLISTENTRY *se;
    se=GWEN_StringList_FirstEntry(sl);
    if (se) {
      GWEN_BUFFER *tbuf;
 
      tbuf=GWEN_Buffer_new(0, 256, 0, 1);
      while (se) {
        const char *s;
 
        s=GWEN_StringListEntry_Data(se);
        assert(s);
        if (relPath) {
          GWEN_Buffer_AppendString(tbuf, s);
          GWEN_Buffer_AppendString(tbuf, GWEN_DIR_SEPARATOR_S);
          GWEN_Buffer_AppendString(tbuf, relPath);
          GWEN_StringList_AppendString(dlg->mediaPaths, GWEN_Buffer_GetStart(tbuf), 0, 1);
          GWEN_Buffer_Reset(tbuf);
        }
        else
          GWEN_StringList_AppendString(dlg->mediaPaths, s, 0, 1);
        se=GWEN_StringListEntry_Next(se);
      }
      GWEN_Buffer_free(tbuf);
    }
    GWEN_StringList_free(sl);
  }
}
 
 
 
GWEN_STRINGLIST *GWEN_Dialog_GetMediaPaths(const GWEN_DIALOG *dlg)
{
  assert(dlg);
  assert(dlg->refCount);
 
  return dlg->mediaPaths;
}
 
 
 
GWEN_DIALOG_SIGNALHANDLER GWEN_Dialog_SetSignalHandler(GWEN_DIALOG *dlg,
                                                       GWEN_DIALOG_SIGNALHANDLER fn)
{
  GWEN_DIALOG_SIGNALHANDLER oh;
 
  assert(dlg);
  assert(dlg->refCount);
 
  oh=dlg->signalHandler;
  dlg->signalHandler=fn;
 
  return oh;
}
 
 
 
int GWEN_Dialog_EmitSignal(GWEN_DIALOG *dlg,
                           GWEN_DIALOG_EVENTTYPE t,
                           const char *sender)
{
  return GWEN_Dialog_EmitSignal2(dlg, t, sender, -1, NULL);
}
 
 
 
int GWEN_Dialog_EmitSignalToAll(GWEN_DIALOG *dlg,
                                GWEN_DIALOG_EVENTTYPE t,
                                const char *sender)
{
  return GWEN_Dialog_EmitSignalToAll2(dlg, t, sender, -1, NULL);
}
 
 
 
GWEN_DIALOG_SIGNALHANDLER2 GWEN_Dialog_SetSignalHandler2(GWEN_DIALOG *dlg,
                                                        GWEN_DIALOG_SIGNALHANDLER2 fn)
{
  GWEN_DIALOG_SIGNALHANDLER2 oh;
 
  assert(dlg);
  assert(dlg->refCount);
 
  oh=dlg->signalHandler2;
  dlg->signalHandler2=fn;
 
  return oh;
}
 
 
 
int GWEN_Dialog_EmitSignal2(GWEN_DIALOG *dlg,
                            GWEN_DIALOG_EVENTTYPE t,
                            const char *sender,
                            int intArg,
                            const char *stringArg)
{
  assert(dlg);
  assert(dlg->refCount);
 
  if (dlg->signalHandler2)
    return (dlg->signalHandler2)(dlg, t, sender, intArg, stringArg);
  else if (dlg->signalHandler)
    return (dlg->signalHandler)(dlg, t, sender);
  else {
    DBG_WARN(GWEN_LOGDOMAIN, "No signal handler in dialog [%s]",
             (dlg->dialogId)?(dlg->dialogId):"-unnamed-");
    return GWEN_DialogEvent_ResultNotHandled;
  }
}
 
 
 
int GWEN_Dialog_EmitSignalToAll2(GWEN_DIALOG *dlg,
                                 GWEN_DIALOG_EVENTTYPE t,
                                 const char *sender,
                                 int intArg,
                                 const char *stringArg)
{
  int rv;
  GWEN_DIALOG *subdlg;
  int anyDialogHasHandledThisSignal=0;
 
  assert(dlg);
  assert(dlg->refCount);
 
  subdlg=GWEN_Dialog_List_First(dlg->subDialogs);
  while (subdlg) {
    rv=GWEN_Dialog_EmitSignalToAll2(subdlg, t, sender, intArg, stringArg);
    if (rv==GWEN_DialogEvent_ResultHandled)
      anyDialogHasHandledThisSignal=1;
    if (rv!=GWEN_DialogEvent_ResultHandled &&
        rv!=GWEN_DialogEvent_ResultNotHandled)
      return rv;
    subdlg=GWEN_Dialog_List_Next(subdlg);
  }
 
  if (dlg->signalHandler2) {
    rv=(dlg->signalHandler2)(dlg, t, sender, intArg, stringArg);
    if (rv==GWEN_DialogEvent_ResultHandled)
      anyDialogHasHandledThisSignal=1;
    if (rv!=GWEN_DialogEvent_ResultHandled &&
        rv!=GWEN_DialogEvent_ResultNotHandled)
      return rv;
  }
  else if (dlg->signalHandler) {
    rv=(dlg->signalHandler)(dlg, t, sender);
    if (rv==GWEN_DialogEvent_ResultHandled)
      anyDialogHasHandledThisSignal=1;
    if (rv!=GWEN_DialogEvent_ResultHandled &&
        rv!=GWEN_DialogEvent_ResultNotHandled)
      return rv;
  }
 
  if (anyDialogHasHandledThisSignal)
    return GWEN_DialogEvent_ResultHandled;
  else
    return GWEN_DialogEvent_ResultNotHandled;
}
 
 
 
int GWEN_Dialog_AddSubDialog(GWEN_DIALOG *dlg,
                             const char *parentName,
                             GWEN_DIALOG *subdlg)
{
  GWEN_WIDGET *wparent;
 
  wparent=GWEN_Dialog_FindWidgetByName(dlg, parentName);
  if (wparent) {
    GWEN_WIDGET *subRoot;
    GWEN_WIDGET *cw;
 
    /* move all widgets from the below sub dialog's root widget to the parent dialog */
    subRoot=GWEN_Widget_Tree_GetFirst(subdlg->widgets);
    if (subRoot) {
      while ((cw=GWEN_Widget_Tree_GetFirstChild(subRoot))) {
        if (subdlg->firstSubWidget==NULL)
          subdlg->firstSubWidget=cw;
        GWEN_Widget_Tree_Del(cw);
        GWEN_Widget_Tree_AddChild(wparent, cw);
      }
    }
 
    /* store pointer to parent widget in dialog */
    subdlg->parentWidget=wparent;
 
    /* store pointer to parent dialog in dialog */
    subdlg->parentDialog=dlg;
 
    GWEN_Dialog_List_Add(subdlg, dlg->subDialogs);
 
    return 0;
  }
  else {
    DBG_ERROR(GWEN_LOGDOMAIN, "Parent widget [%s] not found", parentName);
    return GWEN_ERROR_NOT_FOUND;
  }
}
 
 
 
int GWEN_Dialog__ReadXmlWidget(GWEN_DIALOG *dlg,
                               GWEN_WIDGET *wparent,
                               GWEN_XMLNODE *node)
{
  GWEN_XMLNODE *n;
  GWEN_WIDGET *w;
  int rv;
 
  w=GWEN_Widget_new(dlg);
  rv=GWEN_Widget_ReadXml(w, node);
  if (rv<0) {
    DBG_INFO(GWEN_LOGDOMAIN, "here (%d)", rv);
    GWEN_Widget_free(w);
    return rv;
  }
 
  if (wparent)
    GWEN_Widget_Tree_AddChild(wparent, w);
  else
    GWEN_Widget_Tree_Add(dlg->widgets, w);
 
 
  n=GWEN_XMLNode_FindFirstTag(node, "widget", NULL, NULL);
  while (n) {
    int rv;
 
    rv=GWEN_Dialog__ReadXmlWidget(dlg, w, n);
    if (rv<0)
      return rv;
    n=GWEN_XMLNode_FindNextTag(n, "widget", NULL, NULL);
  }
 
  return 0;
}
 
 
 
int GWEN_Dialog_ReadXml(GWEN_DIALOG *dlg, GWEN_XMLNODE *node)
{
  int rv;
  const char *s;
 
  assert(dlg);
  assert(dlg->refCount);
 
  assert(dlg->widgets);
  GWEN_Widget_Tree_Clear(dlg->widgets);
 
  s=GWEN_XMLNode_GetProperty(node, "i18n", NULL);
  if (s && *s)
    GWEN_Dialog_SetI18nDomain(dlg, s);
 
  rv=GWEN_Dialog__ReadXmlWidget(dlg, NULL, node);
  if (rv<0) {
    DBG_INFO(GWEN_LOGDOMAIN, "here (%d)", rv);
    GWEN_Widget_Tree_free(dlg->widgets);
    dlg->widgets=NULL;
    return rv;
  }
 
  return 0;
}
 
 
 
int GWEN_Dialog_ReadXmlFile(GWEN_DIALOG *dlg, const char *fname)
{
  GWEN_XMLNODE *n;
  GWEN_XMLNODE *nDialog;
  int rv;
 
  n=GWEN_XMLNode_new(GWEN_XMLNodeTypeTag, "root");
  rv=GWEN_XML_ReadFile(n, fname,
                       GWEN_XML_FLAGS_DEFAULT |
                       GWEN_XML_FLAGS_HANDLE_HEADERS);
  if (rv<0) {
    DBG_ERROR(GWEN_LOGDOMAIN, "here (%d)", rv);
    GWEN_XMLNode_free(n);
    return rv;
  }
 
  nDialog=GWEN_XMLNode_FindFirstTag(n, "dialog", NULL, NULL);
  if (nDialog==NULL) {
    DBG_ERROR(GWEN_LOGDOMAIN, "Dialog element not found in XML file [%s]", fname);
    GWEN_XMLNode_free(n);
    return rv;
  }
 
  rv=GWEN_Dialog_ReadXml(dlg, nDialog);
  if (rv<0) {
    DBG_INFO(GWEN_LOGDOMAIN, "here (%d)", rv);
    GWEN_XMLNode_free(n);
    return rv;
  }
 
  GWEN_XMLNode_free(n);
  return 0;
}
 
 
 
GWEN_WIDGET *GWEN_Dialog_FindWidgetByName(const GWEN_DIALOG *dlg, const char *name)
{
  GWEN_WIDGET *w;
 
  assert(dlg);
  assert(dlg->refCount);
  assert(dlg->widgets);
 
#if 0
  if (dlg->parentWidget)
    w=dlg->parentWidget;
  else
    w=GWEN_Widget_Tree_GetFirst(dlg->widgets);
#else
  if (dlg->firstSubWidget)
    w=dlg->firstSubWidget;
  else {
    w=GWEN_Widget_Tree_GetFirst(dlg->widgets);
    /* empty name always corresponds to the root */
    if (name==NULL || *name==0)
      return w;
  }
#endif
 
  while (w) {
    const char *s;
 
    s=GWEN_Widget_GetName(w);
    if (s && *s && strcasecmp(s, name)==0)
      break;
    w=GWEN_Widget_Tree_GetBelow(w);
  }
 
  return w;
}
 
 
 
GWEN_WIDGET *GWEN_Dialog_FindWidgetByImplData(const GWEN_DIALOG *dlg, int index, const void *ptr)
{
  GWEN_WIDGET *w;
 
  assert(dlg);
  assert(dlg->refCount);
  assert(dlg->widgets);
 
  if (dlg->parentWidget)
    w=dlg->parentWidget;
  else
    w=GWEN_Widget_Tree_GetFirst(dlg->widgets);
 
  while (w) {
    if (ptr==GWEN_Widget_GetImplData(w, index))
      break;
    w=GWEN_Widget_Tree_GetBelow(w);
  }
 
  return w;
}
 
 
 
GWEN_WIDGET_TREE *GWEN_Dialog_GetWidgets(const GWEN_DIALOG *dlg)
{
  assert(dlg);
  assert(dlg->refCount);
  assert(dlg->widgets);
 
  return dlg->widgets;
}
 
 
 
GWEN_DIALOG_SETINTPROPERTY_FN GWEN_Dialog_SetSetIntPropertyFn(GWEN_DIALOG *dlg,
                                                              GWEN_DIALOG_SETINTPROPERTY_FN fn)
{
  GWEN_DIALOG_SETINTPROPERTY_FN oh;
 
  assert(dlg);
  assert(dlg->refCount);
 
  oh=dlg->setIntPropertyFn;
  dlg->setIntPropertyFn=fn;
  return oh;
}
 
 
 
GWEN_DIALOG_GETINTPROPERTY_FN GWEN_Dialog_SetGetIntPropertyFn(GWEN_DIALOG *dlg,
                                                              GWEN_DIALOG_GETINTPROPERTY_FN fn)
{
  GWEN_DIALOG_GETINTPROPERTY_FN oh;
 
  assert(dlg);
  assert(dlg->refCount);
 
  oh=dlg->getIntPropertyFn;
  dlg->getIntPropertyFn=fn;
  return oh;
}
 
 
 
GWEN_DIALOG_SETCHARPROPERTY_FN GWEN_Dialog_SetSetCharPropertyFn(GWEN_DIALOG *dlg,
                                                                GWEN_DIALOG_SETCHARPROPERTY_FN fn)
{
  GWEN_DIALOG_SETCHARPROPERTY_FN oh;
 
  assert(dlg);
  assert(dlg->refCount);
 
  oh=dlg->setCharPropertyFn;
  dlg->setCharPropertyFn=fn;
  return oh;
}
 
 
 
GWEN_DIALOG_GETCHARPROPERTY_FN GWEN_Dialog_SetGetCharPropertyFn(GWEN_DIALOG *dlg,
                                                                GWEN_DIALOG_GETCHARPROPERTY_FN fn)
{
  GWEN_DIALOG_GETCHARPROPERTY_FN oh;
 
  assert(dlg);
  assert(dlg->refCount);
 
  oh=dlg->getCharPropertyFn;
  dlg->getCharPropertyFn=fn;
  return oh;
}
 
 
 
 
 
 
int GWEN_Dialog_SetIntProperty(GWEN_DIALOG *dlg,
                               const char *name,
                               GWEN_DIALOG_PROPERTY prop,
                               int index,
                               int value,
                               int doSignal)
{
  GWEN_WIDGET *w;
 
  assert(dlg);
  assert(dlg->refCount);
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    if (dlg->setIntPropertyFn)
      return dlg->setIntPropertyFn(dlg, w, prop, index, value, doSignal);
    else if (dlg->parentDialog && dlg->parentDialog->setIntPropertyFn)
      return dlg->parentDialog->setIntPropertyFn(dlg->parentDialog, w, prop, index, value, doSignal);
  }
  else {
    DBG_ERROR(GWEN_LOGDOMAIN, "Widget [%s] not found", name);
    return GWEN_ERROR_NOT_FOUND;
  }
 
  DBG_ERROR(GWEN_LOGDOMAIN, "Function pointer not set");
  return GWEN_ERROR_NOT_IMPLEMENTED;
}
 
 
 
int GWEN_Dialog_GetIntProperty(GWEN_DIALOG *dlg,
                               const char *name,
                               GWEN_DIALOG_PROPERTY prop,
                               int index,
                               int defaultProperty)
{
  GWEN_WIDGET *w;
 
  assert(dlg);
  assert(dlg->refCount);
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    if (dlg->getIntPropertyFn)
      return dlg->getIntPropertyFn(dlg, w, prop, index, defaultProperty);
    else if (dlg->parentDialog && dlg->parentDialog->getIntPropertyFn)
      return dlg->parentDialog->getIntPropertyFn(dlg->parentDialog, w, prop, index, defaultProperty);
  }
  else {
    DBG_ERROR(GWEN_LOGDOMAIN, "Widget [%s] not found", name);
    return defaultProperty;
  }
 
  DBG_ERROR(GWEN_LOGDOMAIN, "Function pointer not set");
  return defaultProperty;
}
 
 
 
int GWEN_Dialog_SetCharProperty(GWEN_DIALOG *dlg,
                                const char *name,
                                GWEN_DIALOG_PROPERTY prop,
                                int index,
                                const char *value,
                                int doSignal)
{
  GWEN_WIDGET *w;
 
  assert(dlg);
  assert(dlg->refCount);
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    if (dlg->setCharPropertyFn)
      return dlg->setCharPropertyFn(dlg, w, prop, index, value, doSignal);
    else if (dlg->parentDialog && dlg->parentDialog->setCharPropertyFn)
      return dlg->parentDialog->setCharPropertyFn(dlg->parentDialog, w, prop, index, value, doSignal);
  }
  else {
    DBG_ERROR(GWEN_LOGDOMAIN, "Widget [%s] not found", name);
    return GWEN_ERROR_NOT_FOUND;
  }
 
  DBG_ERROR(GWEN_LOGDOMAIN, "Function pointer not set");
  return GWEN_ERROR_NOT_IMPLEMENTED;
}
 
 
 
const char *GWEN_Dialog_GetCharProperty(GWEN_DIALOG *dlg,
                                        const char *name,
                                        GWEN_DIALOG_PROPERTY prop,
                                        int index,
                                        const char *defaultProperty)
{
  GWEN_WIDGET *w;
 
  assert(dlg);
  assert(dlg->refCount);
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    if (dlg->getCharPropertyFn)
      return dlg->getCharPropertyFn(dlg, w, prop, index, defaultProperty);
    else if (dlg->parentDialog && dlg->parentDialog->getCharPropertyFn)
      return dlg->parentDialog->getCharPropertyFn(dlg->parentDialog, w, prop, index, defaultProperty);
  }
  else {
    DBG_ERROR(GWEN_LOGDOMAIN, "Widget [%s] not found", name);
    return defaultProperty;
  }
 
  DBG_ERROR(GWEN_LOGDOMAIN, "Function pointer not set");
  return defaultProperty;
}
 
 
 
int GWEN_Dialog_RemoveWidget(GWEN_DIALOG *dlg, const char *name)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    GWEN_Widget_Tree_Del(w);
    GWEN_Widget_free(w);
    return 0;
  }
 
  return GWEN_ERROR_NOT_FOUND;
}
 
 
uint32_t GWEN_Dialog_GetWidgetFlags(const GWEN_DIALOG *dlg, const char *name)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    return GWEN_Widget_GetFlags(w);
  }
 
  return 0;
}
 
 
 
void GWEN_Dialog_SetWidgetFlags(GWEN_DIALOG *dlg, const char *name, uint32_t fl)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    GWEN_Widget_SetFlags(w, fl);
  }
}
 
 
 
void GWEN_Dialog_AddWidgetFlags(GWEN_DIALOG *dlg, const char *name, uint32_t fl)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    GWEN_Widget_AddFlags(w, fl);
  }
}
 
 
 
void GWEN_Dialog_SubWidgetFlags(GWEN_DIALOG *dlg, const char *name, uint32_t fl)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    GWEN_Widget_SubFlags(w, fl);
  }
}
 
 
 
int GWEN_Dialog_GetWidgetColumns(const GWEN_DIALOG *dlg, const char *name)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    return GWEN_Widget_GetColumns(w);
  }
 
  return -1;
}
 
 
 
void GWEN_Dialog_SetWidgetColumns(GWEN_DIALOG *dlg, const char *name, int i)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    GWEN_Widget_SetColumns(w, i);
  }
}
 
 
 
int GWEN_Dialog_GetWidgetRows(const GWEN_DIALOG *dlg, const char *name)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    return GWEN_Widget_GetRows(w);
  }
 
  return -1;
}
 
 
 
void GWEN_Dialog_SetWidgetRows(GWEN_DIALOG *dlg, const char *name, int i)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    GWEN_Widget_SetRows(w, i);
  }
}
 
 
 
void GWEN_Dialog_SetWidgetText(GWEN_DIALOG *dlg, const char *name, const char *t)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    GWEN_Widget_SetText(w, 0, t);
  }
}
 
 
 
const char *GWEN_Dialog_GetWidgetText(const GWEN_DIALOG *dlg, const char *name)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Dialog_FindWidgetByName(dlg, name);
  if (w) {
    return GWEN_Widget_GetText(w, 0);
  }
 
  return NULL;
}
 
 
 
static void GWEN_Dialog_DumpWidget(const GWEN_WIDGET *w, FILE *f, unsigned int indent)
{
  int i;
  const char *s;
  const char *dname=NULL;
  GWEN_DIALOG *dlg;
  const GWEN_WIDGET *c;
 
  for (i=0; i<indent; i++)
    fprintf(f, " ");
  s=GWEN_Widget_GetName(w);
  dlg=GWEN_Widget_GetDialog(w);
  if (dlg)
    dname=GWEN_Dialog_GetId(dlg);
 
  fprintf(f, "Widget %s: %d [%s]\n", s?s:"unnamed", GWEN_Widget_GetType(w), dname?dname:"no dialog");
  c=GWEN_Widget_Tree_GetFirstChild(w);
  while (c) {
    GWEN_Dialog_DumpWidget(c, f, indent+2);
    c=GWEN_Widget_Tree_GetNext(c);
  }
}
 
 
 
void GWEN_Dialog_Dump(const GWEN_DIALOG *dlg, FILE *f, unsigned int indent)
{
  GWEN_WIDGET *w;
 
  w=GWEN_Widget_Tree_GetFirst(dlg->widgets);
  GWEN_Dialog_DumpWidget(w, f, indent);
}
 
 
 
 
 
 
GWEN_DB_NODE *GWEN_Dialog_GetPreferences(const GWEN_DIALOG *dlg)
{
  assert(dlg);
  assert(dlg->refCount);
 
  return dlg->dbPreferences;
}
 
 
 
 
 
void GWEN_Dialog_ListWriteColumnSettings(GWEN_DIALOG *dlg,
                                         const char *widgetName,
                                         const char *variablePrefix,
                                         int maxColumns,
                                         int minColumnSize,
                                         GWEN_DB_NODE *dbPrefs)
{
  GWEN_BUFFER *nameBuf;
  uint32_t posInBuffer;
  int i;
 
  nameBuf=GWEN_Buffer_new(0, 256, 0, 1);
  GWEN_Buffer_AppendString(nameBuf, variablePrefix);
  posInBuffer=GWEN_Buffer_GetPos(nameBuf);
 
  /* write column sizes */
  GWEN_Buffer_AppendString(nameBuf, "columns");
  GWEN_DB_DeleteVar(dbPrefs, GWEN_Buffer_GetStart(nameBuf));
  for (i=0; i<maxColumns; i++) {
    int j;
 
    j=GWEN_Dialog_GetIntProperty(dlg, widgetName, GWEN_DialogProperty_ColumnWidth, i, -1);
    if (j<minColumnSize)
      j=minColumnSize;
    GWEN_DB_SetIntValue(dbPrefs, GWEN_DB_FLAGS_DEFAULT, GWEN_Buffer_GetStart(nameBuf), j);
  }
 
  /* determine column to sort by */
  GWEN_Buffer_Crop(nameBuf, 0, posInBuffer);
  GWEN_Buffer_AppendString(nameBuf, "sortbycolumn");
  GWEN_DB_SetIntValue(dbPrefs, GWEN_DB_FLAGS_OVERWRITE_VARS, GWEN_Buffer_GetStart(nameBuf), -1);
  for (i=0; i<maxColumns; i++) {
    int j;
 
    j=GWEN_Dialog_GetIntProperty(dlg, widgetName, GWEN_DialogProperty_SortDirection, i, GWEN_DialogSortDirection_None);
    if (j!=GWEN_DialogSortDirection_None) {
 
      GWEN_DB_SetIntValue(dbPrefs, GWEN_DB_FLAGS_OVERWRITE_VARS, GWEN_Buffer_GetStart(nameBuf), i);
 
      GWEN_Buffer_Crop(nameBuf, 0, posInBuffer);
      GWEN_Buffer_AppendString(nameBuf, "sortdir");
      GWEN_DB_SetIntValue(dbPrefs,
                          GWEN_DB_FLAGS_OVERWRITE_VARS,
                          GWEN_Buffer_GetStart(nameBuf),
                          (j==GWEN_DialogSortDirection_Up)?1:0);
      break;
    }
  }
  GWEN_Buffer_free(nameBuf);
}
 
 
 
void GWEN_Dialog_ListReadColumnSettings(GWEN_DIALOG *dlg,
                                        const char *widgetName,
                                        const char *variablePrefix,
                                        int maxColumns,
                                        int minColumnSize,
                                        GWEN_DB_NODE *dbPrefs)
{
  GWEN_BUFFER *nameBuf;
  uint32_t posInBuffer;
  int i;
  int j;
 
  nameBuf=GWEN_Buffer_new(0, 256, 0, 1);
  GWEN_Buffer_AppendString(nameBuf, variablePrefix);
  posInBuffer=GWEN_Buffer_GetPos(nameBuf);
 
  /* read column sizes */
  GWEN_Buffer_AppendString(nameBuf, "columns");
  for (i=0; i<maxColumns; i++) {
    j=GWEN_DB_GetIntValue(dbPrefs, GWEN_Buffer_GetStart(nameBuf), i, -1);
    if (j<minColumnSize)
      j=minColumnSize;
    GWEN_Dialog_SetIntProperty(dlg, widgetName, GWEN_DialogProperty_ColumnWidth, i, j, 0);
  }
 
  /* determine column to sort by */
  GWEN_Buffer_Crop(nameBuf, 0, posInBuffer);
  GWEN_Buffer_AppendString(nameBuf, "sortbycolumn");
  i=GWEN_DB_GetIntValue(dbPrefs, GWEN_Buffer_GetStart(nameBuf), 0, -1);
  GWEN_Buffer_Crop(nameBuf, 0, posInBuffer);
  GWEN_Buffer_AppendString(nameBuf, "sortdir");
  j=GWEN_DB_GetIntValue(dbPrefs, GWEN_Buffer_GetStart(nameBuf), 0, -1);
  if (i>=0 && j>=0)
    GWEN_Dialog_SetIntProperty(dlg, widgetName, GWEN_DialogProperty_SortDirection, i, j, 0);
  GWEN_Buffer_free(nameBuf);
}
 
 
 
char *GWEN_Dialog_ListGetFirstColumnData(GWEN_DIALOG *dlg, const char *widgetName, int row)
{
  const char *s;
 
  s=GWEN_Dialog_GetCharProperty(dlg, widgetName, GWEN_DialogProperty_Value, row, NULL);
  if (s && *s) {
    const char *p;
 
    p=strchr(s, '\t');
    if (p) {
      int len;
 
      len=(int)(p-s);
      if (len) {
        char *res;
 
        res=(char *) malloc(len+1);
        assert(res);
        memmove(res, s, len);
        res[len]=0;
        return res;
      }
    }
    else
      /* no tab, use the whole line */
      return strdup(s);
  }
 
  return NULL;
}
 
 
 
int GWEN_Dialog_ListGetItemMatchingFirstColumn(GWEN_DIALOG *dlg, const char *widgetName, const char *dataToMatch)
{
  if (dataToMatch) {
    int idx;
    int lengthOfDataToMatch;
 
    lengthOfDataToMatch=strlen(dataToMatch);
    for (idx=0; ; idx++) {
      const char *s;
 
      s=GWEN_Dialog_GetCharProperty(dlg, widgetName, GWEN_DialogProperty_Value, idx, NULL);
      if (s && *s) {
        const char *p;
 
        p=strchr(s, '\t');
        if (p) {
          int len;
 
          len=(int)(p-s);
          if (len && len==lengthOfDataToMatch && strncasecmp(s, dataToMatch, len)==0)
            return idx;
        }
        else if (strcasecmp(s, dataToMatch)==0)
          return idx;
      }
      else
        break;
    }
  }
 
  return -1;
}