dialog_support.h

//         _  _         _                                                            _       _         //
//      __| |(_)  __ _ | |  ___    __ _       ___  _   _  _ __   _ __    ___   _ __ | |_    | |__      //
//     / _` || | / _` || | / _ \  / _` |     / __|| | | || '_ \ | '_ \  / _ \ | '__|| __|   | '_ \     //
//    | (_| || || (_| || || (_) || (_| |     \__ \| |_| || |_) || |_) || (_) || |   | |_  _ | | | |    //
//     \__,_||_| \__,_||_| \___/  \__, |_____|___/ \__,_|| .__/ | .__/  \___/ |_|    \__|(_)|_| |_|    //
//                                |___/|_____|           |_|    |_|                                    //
//                                                                                                     //
//                                                                                                     //
//                                 additional dialog control support                                   //
// This file contains semi-private definitions that are needed to generically support dialog controls  //
//                                                                                                     //

/*****************************************************************************

    X11workbench - X11 programmer's 'work bench' application and toolkit
    Copyright (c) 2010-2019 by Bob Frazier (aka 'Big Bad Bombastic Bob')


  DISCLAIMER:  The X11workbench application and toolkit software are supplied
               'as-is', with no warranties, either implied or explicit.
               Any claims to alleged functionality or features should be
               considered 'preliminary', and might not function as advertised.

  MIT-like license:

  There is no restriction as to what you can do with this software, so long
  as you include the above copyright notice and DISCLAIMER for any distributed
  work that is equal to or derived from this one, along with this paragraph
  that explains the terms of the license if the source is also being made
  available.  A "derived work" describes a work that uses a significant portion
  of the source files or algorithms that are included with thi __WBLineBuffers one.
  Specifically excluded from this are files that were generated by the software,
  or anything that is included with the software that is part of another package
  (such as files that were created or added during the 'configure' process).
  Specifically included is the use of part or all of any of the X11 workbench
  toolkit source or header files in your distributed application.  If you do not
  ship the source, the above copyright statement is still required to be placed
  in a reasonably prominent place, such as documentation, splash screens, and/or
  'about the application' dialog boxes.

  Use and distribution are in accordance with GPL, LGPL, and/or the above
  MIT-like license.  See COPYING and README files for more information.


  Additional information at http://sourceforge.net/projects/X11workbench

******************************************************************************/



// INTERNAL USE ONLY for dialog controls, etc.

#ifndef _DIALOG_SUPPORT_H_INCLUDED_
#define _DIALOG_SUPPORT_H_INCLUDED_

#include "dialog_controls.h" // make sure this is included first
#include "text_object.h" // needed for  s_WB_EDIT_CONTROL


#ifdef __cplusplus
extern "C" {
#endif // __cplusplus


typedef struct s_LISTINFO
{
  int nItems,              
      nMaxItems;           
  int nPos,                
      nTop;                
  int nHeight,             
      nItemHeight;         
  int nFlags;              
  WB_GEOM geomDisplay;     
  Window wOwner;           

  void *(*pfnAllocator)(const void *, int);
  void (*pfnDestructor)(void *);
  void (*pfnDisplay)(WBDialogControl *pControl, void *pData, int iSelected, WBGC gcPaint, WB_GEOM *pGeom, WB_FONTC pFont);

  int (*pfnSort)(const void *, const void *); // sort proc (NULL implies strcmp)

  void *aItems[1];                    // array of item data (remainder of struct)
} LISTINFO;



// specialized structures 'derived' from WBDialogC __WBLineBufferontrol (internal only)
typedef struct s_WB_IMAGE_CONTROL
{
  WBDialogControl wbDLGCtrl; 
  Pixmap pixmap;             
  Pixmap pixmap2;            
} WBImageControl;

typedef struct s_WB_PUSHBUTTON_CONTROL
{
  WBDialogControl wbDLGCtrl; 
  Pixmap pixmap;             
  Pixmap pixmap2;            
} WBPushButtonControl;

typedef struct s_WB_EDIT_CONTROL
{
  WBDialogControl wbDLGCtrl; 
  TEXT_OBJECT xTextObject;   
} WBEditControl;


typedef struct s_WBListCurSel
{
  int iCurSel;      
  int iTopIndex;    
  int iHeight;      
  int iEntryHeight; 
} WBListCurSel;


typedef struct s_WB_LIST_CONTROL
{
  WBDialogControl wbDLGCtrl; 
  WBListCurSel sel;          
  int *pSelBitmap;           
  int cbBitmap;              
  WB_FONT pBold;             
} WBListControl;


typedef struct s_WB_COMBO_CONTROL
{
  WBDialogControl wbDLGCtrl; 
  WBListCurSel sel;          
  TEXT_OBJECT xTextObject;   
} WBComboControl;


typedef struct s_WB_TREE_CONTROL
{
  WBDialogControl wbDLGCtrl; 
  WBListCurSel sel;          
  WB_FONT pBold;             
} WBTreeControl;



void DLGCDestroyProperties(WBDialogPropList *pPropList);

LISTINFO *DLGCListInfoConstructor(Window wOwner, int nMax, int nFlags,
                                  void *(*pfnAllocator)(const void *,int), void (*pfnDestructor)(void *),
                                  void (*pfnDisplay)(WBDialogControl *, void *, int, WBGC, WB_GEOM *, WB_FONTC),
                                  int (*pfnSort)(const void *, const void *));

void DLGCListInfoDestructor(LISTINFO *pListInfo);


void DLGCDefaultListControlDisplayProc(WBDialogControl *pList, void *pData, int iSelected, WBGC gc, WB_GEOM *pGeom, WB_FONTC pFont);



#ifndef DIALOG_SUPPORT_C

extern const Atom aDLGC_TEXT;
extern const Atom aDLGC_CAPTION;
extern const Atom aDLGC_FONT;
extern const Atom aDLGC_SCROLLINFO;
extern const Atom aDLGC_LISTINFO;

#endif // DIALOG_SUPPORT_C


#ifdef NO_DEBUG
#define DEBUG_DUMP_LIST(X)
#else // !NO_DEBUG
void DEBUG_DUMP_LIST(WBDialogControl *pCtrl);
#endif // NO_DEBUG


#ifdef __cplusplus
};
#endif // __cplusplus

#endif // _DIALOG_SUPPORT_H_INCLUDED_