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
|
.TH TICKIT_WINDOWCTL_NAME 3
.SH NAME
tickit_windowctl_name \- return the name of a window control
.SH SYNOPSIS
.EX
.B #include <tickit.h>
.sp
.BI "const char * tickit_windowctl_name(TickitWindowCtl " ctl );
.BI "TickitWindowCtl tickit_windowctl_lookup(const char * " name );
.sp
.BI "TickitType tickit_windowctl_type(TickitWindowCtl " ctl );
.EE
.sp
Link with \fI\-ltickit\fP.
.SH DESCRIPTION
\fBtickit_windowctl_name\fP() returns the name of the given window control. These names are the lowercase strings given in \fBtickit_window\fP(7).
.PP
\fBtickit_windowctl_lookup\fP() returns the control constant for a given name. If the name is not recognised then -1 is returned.
.PP
\fBtickit_windowctl_type\fP() returns the type of the given window control, as one of the following constants:
.in
.TP
.B TICKIT_TYPE_BOOL
The value is an integer representing a simple boolean choice, where any nonzero value is true. Use \fBtickit_window_setctl_int\fP(3) and \fBtickit_window_getctl_int\fP(3).
.TP
.B TICKIT_TYPE_INT
The value is an integer representing a quantity, or a value in some particular enumeration. Use \fBtickit_window_setctl_int\fP(3) and \fBtickit_window_getctl_int\fP(3).
.PP
For unrecognised control types, the function returns 0.
.SH "RETURN VALUE"
\fBtickit_windowctl_name\fP() returns a constant string pointer. \fBtickit_windowctl_lookup\fP() returns an control constant or -1. \fBtickit_windowctl_type\fP() returns a control type constant or 0.
.SH "SEE ALSO"
.BR tickit_window (7),
.BR tickit (7)
|
