---
name: "tickit_windowctl_type"
section: "3"
platform: "linux"
package: "libtickit-dev"
version: "0.4.3-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tickit_windowctl_type"
---

# tickit\_windowctl\_type(3)

return the name of a window control

## NAME

tickit\_windowctl\_name - return the name of a window control

## SYNOPSIS

```
#include <tickit.h>

const char * tickit_windowctl_name(TickitWindowCtl ctl);
TickitWindowCtl tickit_windowctl_lookup(const char * name);

TickitType tickit_windowctl_type(TickitWindowCtl ctl);
```

Link with *-ltickit*.

## DESCRIPTION

**tickit\_windowctl\_name**() returns the name of the given window control. These names are the lowercase strings given in [**tickit\_window**(7)](/tickit_window/7.md).

**tickit\_windowctl\_lookup**() returns the control constant for a given name. If the name is not recognised then -1 is returned.

**tickit\_windowctl\_type**() returns the type of the given window control, as one of the following constants:

- **TICKIT\_TYPE\_BOOL**

  The value is an integer representing a simple boolean choice, where any nonzero value is true. Use [**tickit\_window\_setctl\_int**(3)](/tickit_window_setctl_int/3.md) and [**tickit\_window\_getctl\_int**(3)](/tickit_window_getctl_int/3.md).

- **TICKIT\_TYPE\_INT**

  The value is an integer representing a quantity, or a value in some particular enumeration. Use [**tickit\_window\_setctl\_int**(3)](/tickit_window_setctl_int/3.md) and [**tickit\_window\_getctl\_int**(3)](/tickit_window_getctl_int/3.md).

For unrecognised control types, the function returns 0.

## RETURN VALUE

**tickit\_windowctl\_name**() returns a constant string pointer. **tickit\_windowctl\_lookup**() returns an control constant or -1. **tickit\_windowctl\_type**() returns a control type constant or 0.

## SEE ALSO

[**tickit\_window**(7)](/tickit_window/7.md), [**tickit**(7)](/tickit/7.md)
