1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
/*
* Smithsonian Astrophysical Observatory, Cambridge, MA, USA
* This code has been modified under the terms listed below and is made
* available under the same terms.
*/
/*
* bltSwitch.h --
*
* Copyright 1993-2004 George A Howlett.
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or
* sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following
* conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the
* Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
* KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
* WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
* PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
* OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
* OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
#ifndef BLT_SWITCH_H
#define BLT_SWITCH_H
# include <stddef.h>
typedef int (Blt_SwitchParseProc)(ClientData clientData, Tcl_Interp* interp,
const char *switchName, Tcl_Obj *valueObjPtr, char *record, int offset,
int flags);
typedef void (Blt_SwitchFreeProc)(char *record, int offset, int flags);
typedef struct {
Blt_SwitchParseProc *parseProc; /* Procedure to parse a switch
* value and store it in its *
* converted form in the data *
* record. */
Blt_SwitchFreeProc *freeProc; /* Procedure to free a switch. */
ClientData clientData; /* Arbitrary one-word value used by
* switch parser, passed to
* parseProc. */
} Blt_SwitchCustom;
/*
* Type values for Blt_SwitchSpec structures. See the user
* documentation for details.
*/
typedef enum {
BLT_SWITCH_BOOLEAN,
BLT_SWITCH_DOUBLE,
BLT_SWITCH_BITMASK,
BLT_SWITCH_BITMASK_INVERT,
BLT_SWITCH_FLOAT,
BLT_SWITCH_INT,
BLT_SWITCH_INT_NNEG,
BLT_SWITCH_INT_POS,
BLT_SWITCH_LIST,
BLT_SWITCH_LONG,
BLT_SWITCH_LONG_NNEG,
BLT_SWITCH_LONG_POS,
BLT_SWITCH_OBJ,
BLT_SWITCH_STRING,
BLT_SWITCH_VALUE,
BLT_SWITCH_CUSTOM,
BLT_SWITCH_END
} Blt_SwitchTypes;
typedef struct {
Blt_SwitchTypes type; /* Type of option, such as
* BLT_SWITCH_COLOR; see definitions
* below. Last option in table must
* have type BLT_SWITCH_END. */
const char *switchName; /* Switch used to specify option in
* argv. NULL means this spec is part
* of a group. */
const char *help; /* Help string. */
int offset; /* Where in widget record to store
* value; use Blt_Offset macro to
* generate values for this. */
int flags; /* Any combination of the values
* defined below. */
unsigned int mask;
Blt_SwitchCustom *customPtr; /* If type is BLT_SWITCH_CUSTOM then
* this is a pointer to info about how
* to parse and print the option.
* Otherwise it is irrelevant. */
} Blt_SwitchSpec;
#define BLT_SWITCH_DEFAULTS (0)
#define BLT_SWITCH_ARGV_PARTIAL (1<<1)
#define BLT_SWITCH_OBJV_PARTIAL (1<<1)
/*
* Possible flag values for Blt_SwitchSpec structures. Any bits at or
* above BLT_SWITCH_USER_BIT may be used by clients for selecting
* certain entries.
*/
#define BLT_SWITCH_NULL_OK (1<<0)
#define BLT_SWITCH_DONT_SET_DEFAULT (1<<3)
#define BLT_SWITCH_SPECIFIED (1<<4)
#define BLT_SWITCH_USER_BIT (1<<8)
extern int Blt_ParseSwitches(Tcl_Interp* interp, Blt_SwitchSpec *specPtr,
int objc, Tcl_Obj *const *objv, void *rec, int flags);
extern void Blt_FreeSwitches(Blt_SwitchSpec *specs, void *rec, int flags);
#endif /* BLT_SWITCH_H */
|