---
name: "AddOption"
section: "3"
platform: "macos"
package: "tcl"
version: "152"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/AddOption"
---

# AddOption(3)

Add an option to the option database

## NAME

Tk\_AddOption - Add an option to the option database

## SYNOPSIS

```
#include <tk.h>

void
Tk_AddOption(tkwin, name, value, priority)
```

## ARGUMENTS

Token for window. Multi-element name of option. Value of option. Overall priority level to use for option.

## DESCRIPTION

This procedure 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**.  Some common priority values are:

- 20

  Used for default values hard-coded into widgets.

- 40

  Used for options specified in application-specific startup files.

- 60

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

- 80

  Used for options specified interactively after the application starts running.

## KEYWORDS

class, name, option, add