uidialog.h

来自「开放源码的编译器open watcom 1.6.0版的源代码」· C头文件 代码 · 共 231 行

/****************************************************************************
*
*                            Open Watcom Project
*
*    Portions Copyright (c) 1983-2002 Sybase, Inc. All Rights Reserved.
*
*  ========================================================================
*
*    This file contains Original Code and/or Modifications of Original
*    Code as defined in and that are subject to the Sybase Open Watcom
*    Public License version 1.0 (the 'License'). You may not use this file
*    except in compliance with the License. BY USING THIS FILE YOU AGREE TO
*    ALL TERMS AND CONDITIONS OF THE LICENSE. A copy of the License is
*    provided with the Original Code and Modifications, and is also
*    available at www.sybase.com/developer/opensource.
*
*    The Original Code and all software distributed under the License are
*    distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
*    EXPRESS OR IMPLIED, AND SYBASE AND ALL CONTRIBUTORS HEREBY DISCLAIM
*    ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF
*    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR
*    NON-INFRINGEMENT. Please see the License for the specific language
*    governing rights and limitations under the License.
*
*  ========================================================================
*
* Description:  WHEN YOU FIGURE OUT WHAT THIS FILE DOES, PLEASE
*               DESCRIBE IT HERE!
*
****************************************************************************/


#ifndef _UIDIALOG_H
#define _UIDIALOG_H

#include "uigadget.h"       /* for list_box structure element */
#include "uivedit.h"
#include "uiledit.h"

typedef unsigned        a_field_type;

#define HOT_NO_KEY      0x1000
#define HOT_HIDDEN      0x0800
#define HOT_ACTIVE      0x0400
#define HOT_CURRENT     0x0200
#define HOT_DEFAULT     0x0100
#define HOT_CHAR        0x00ff

enum {
        FLD_VOID,
        FLD_FRAME,
        FLD_LABEL,
        FLD_TEXT,          /* background text      * must be */
        FLD_HOT,           /* hot spot             * first   */
        FLD_EDIT,
        FLD_INVISIBLE_EDIT,
        FLD_LISTBOX,
        FLD_PULLDOWN,
        FLD_COMBOBOX,
        FLD_CHECK,
        FLD_RADIO,
        FLD_EDIT_MLE
};

typedef struct an_edit_control {
        char            *buffer;
        unsigned        length;
} an_edit_control;

typedef struct a_list_info {
    VSCREEN         *vs;
    SAREA           area;
    a_gadget        gadget;
    unsigned        line;
    unsigned        row;
    ATTR            attr;       // attribute for highlighted item
} a_list_info;

typedef struct a_choice {
        unsigned        choice;
        unsigned        num_choices;
} a_choice;

typedef struct a_num_field {          /* display is choice+diff */
        a_choice        c;
        int             diff;
        char            *special;     /* non numeric displayed for choice==0 */
} a_num_field;

typedef struct a_hot_spot {
        char            *str;
        EVENT           event;
        int             row;
        int             startcol;
        int             length;
        unsigned short  flags;
} a_hot_spot;

typedef struct a_toggle {
        a_choice        c;
        char            **strings;
} a_toggle;

typedef struct a_list {
        unsigned        choice;
        void            *data;
        bool            (*get)( void *, unsigned, char *, unsigned );
        a_list_info     *box;
} a_list;

typedef struct a_check {
        unsigned    char    val;
        unsigned    char    def;
        char                *str;   // without button
        char                hotkey; // will be set by UI
} a_check;

typedef struct a_combo_box {
        a_list              list;
        an_edit_control     edit;
        int                 perm;   // bool : permanent combo-box ?
} a_combo_box;

#define _checked( a ) ( !( a->val == a->def ) )

typedef struct a_radio_group {
        unsigned value;
        char     *caption;      // used for printing and reading
        unsigned def;           // default value (used as above)
} a_radio_group;

typedef struct a_radio {
        unsigned      value;
        char          *str;        // without button
        a_radio_group *group;
        char          hotkey;      // will be set by UI
} a_radio;

typedef struct vfield {
        SAREA           area;
        a_field_type    typ;
        void            *ptr;
} VFIELD;

typedef struct a_hot_spot_field{
        SAREA           area;
        a_field_type    typ;
        a_hot_spot      *ptr;
}a_hot_spot_field;

typedef struct a_dialog {
        void            *vs;
        unsigned        field;
        VFIELD          *fields;        // pointer to VFIELDs
        VFIELD          *other;         // prev VFIELD or moused but no tab
        VFIELD          *curr;          // current VFIELD
        VFIELD          *first;         // first VFIELD
        a_ui_edit       *edit_data;
        unsigned        dirty:1;
        unsigned        moving:1;
} a_dialog;

#ifdef __cplusplus
    extern "C" {
#endif
extern void uiposnhotspots(struct vscreen *,void *);
extern void uiprinthotspots(struct vscreen *,void *);
extern void uioffhotspots(struct vscreen *,void *);
extern int  uihotkeyfilter( a_dialog *, int );
extern int  uihotspotfilter(struct vscreen *,void *,int );
extern char uihotspot( struct vscreen *, char *str, SAREA *parea, unsigned short flags );
extern char uidrawhottext( struct vscreen *, char *str, SAREA *parea, ATTR attr, ATTR hotattr, bool hidden, bool no_hotkey, bool centre_text );

extern unsigned int ui_split_line(char **,char *,unsigned int );
extern void *uiinitdialog(char *, ATTR, char **, unsigned int, int, int, int );
extern void uifinidialog(void *);

extern void *uibegdialog(char *, VFIELD *, ORD, ORD, int, int );
extern bool uigetdialogarea( struct a_dialog *dialog, SAREA *area );
extern EVENT uiprocessdialogevent( EVENT, struct a_dialog* );
extern void uireinitdialog( struct a_dialog *, struct vfield *);
extern int uidialog(struct a_dialog *);
extern void uienddialog(struct a_dialog *);
extern void uifreedialog( a_dialog *info );
extern void uiprintfield(struct a_dialog *, struct vfield *);
extern void uimovefield( struct a_dialog *, struct vfield *, int row_diff, int col_diff );
extern bool uiresizedialog( struct a_dialog *info, SAREA *new_area );
extern void uiredrawdialog( a_dialog *info );
extern bool uidialogisdirty( struct a_dialog *);
extern void uidialogsetdirty( struct a_dialog *, bool );
extern void uidialogsetcurr( struct a_dialog *, struct vfield *);
extern void uidialogexitcurr( struct a_dialog * );
extern void uidialogchangefield( struct a_dialog * );
extern bool uiisdefaulthotspot( void *, EVENT );
extern int uilistbox( int , struct a_list *, bool );
extern void uiupdateedit( struct a_dialog *, struct vfield * );
extern void uiboxpushlist( void );
extern void uiboxpoplist( void );
extern void uimovelistbox( struct a_list *, int row_diff, int col_diff );
extern unsigned uiendlistbox( struct a_list * );
extern void uipaintlistbox( struct a_list * );
extern struct a_list_info *uibeglistbox( struct vscreen *, struct sarea *,
                                         struct a_list * );
extern unsigned uilistsize( struct a_list * );
extern bool uigetlistelement( char **, unsigned, char *, unsigned );
extern void uiupdatelistbox( struct a_list * );
extern void uiupdatecombobox( struct a_combo_box * );
extern void *openstream(char *,char *,char **);
extern void closestream(void *);

/*
 * functions in uidlgfcn.c
 */
extern void uioncheckbox( struct a_dialog *, struct vfield * );
extern void uioffcheckbox( struct a_dialog *, struct vfield * );
extern void uiselectradio( struct a_dialog *, struct vfield * );
extern void uiselectlist( struct a_dialog *, struct vfield *, unsigned choice );
extern void uiselectcombo( struct a_dialog *, struct vfield *, unsigned choice );

/*
 * functions in uidialcb.c
 */

extern EVENT uidialogcallback( a_dialog *, EVENT );

#ifdef __cplusplus
}
#endif

#endif