Tk\_AddOption(3) Tk Library Procedures Tk\_AddOption(3)

```

```

# [NAME](#NAME)

Tk\_AddOption - Add an option to the option database

# [SYNOPSIS](#SYNOPSIS)

```
#include <tk.h>

void
Tk_AddOption(tkwin, name, value, priority)

Tcl_Obj *
Tk_GetSystemDefault(tkwin, dbName, className)
```

# [ARGUMENTS](#ARGUMENTS)

Tk\_Window *tkwin* (in)

Token for window.

const char *\*name* (in)

Multi-element name of option.

const char *\*value* (in)

Value of option.

const char *\*dbName* (in)

The option database name.

const char *\*className* (in)

The name of the option class.

int *priority* (in)

Overall priority level to use for option.

```
    
```

# [DESCRIPTION](#DESCRIPTION)

**Tk\_AddOption** is invoked to add an option to the database associated with *tkwin*'s main window. *Name* contains the option being specified and consists of names and/or classes separated by asterisks or dots, in the usual X format. *Value* contains the text string to associate with *name*; this value will be returned in calls to **Tk\_GetOption**. *Priority* specifies the priority of the value; when options are queried using **Tk\_GetOption**, the value with the highest priority is returned. *Priority* must be between 0 and **TK\_MAX\_PRIO** (100). Some common priority values are:

[**TK\_WIDGET\_DEFAULT\_PRIO**](#TK_WIDGET_DEFAULT_PRIO)

Used for default values hard-coded into widgets.

[**TK\_STARTUP\_FILE\_PRIO**](#TK_STARTUP_FILE_PRIO)

Used for options specified in application-specific startup files.

[**TK\_USER\_DEFAULT\_PRIO**](#TK_USER_DEFAULT_PRIO)

Used for options specified in user-specific defaults files, such as **.Xdefaults**, resource databases loaded into the X server, or user-specific startup files.

[**TK\_INTERACTIVE\_PRIO**](#TK_INTERACTIVE_PRIO)

Used for options specified interactively after the application starts running.

**Tk\_GetSystemDefault** returns a Tcl\_Obj* with the string identifying a configuration option matching the given *dbname* and *className*. Returns NULL if there are no system defaults that match this pair.

# [KEYWORDS](#KEYWORDS)

class, name, option, add

Tk

---

Document: Tk_AddOption(3) from tk 9.1.0-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.1.0-src.tar.gz