## Tcl8.6.17/Tk8.6.17 Documentation > Tk C API > AddOption

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    Tk_AddOption — Add an option to the option database
  SYNOPSIS
    #include <tk.h>
    void
    Tk_AddOption(tkwin, name, value, priority)
  ARGUMENTS
  DESCRIPTION
  TK_WIDGET_DEFAULT_PRIO (20)
  TK_STARTUP_FILE_PRIO (40)
  TK_USER_DEFAULT_PRIO (60)
  TK_INTERACTIVE_PRIO (80)
  KEYWORDS

### NAME

Tk_AddOption — Add an option to the option database

### SYNOPSIS

#include <tk.h>
void
Tk_AddOption(tkwin, name, value, priority)

### ARGUMENTS

Tk_Window tkwin (in)
  Token for window.

const char *name (in)
  Multi-element name of option.

const char *value (in)
  Value of option.

int priority (in)
  Overall priority level to use for option.

### DESCRIPTION

この手続函数は tkwin の主窓と結合した基礎データに指示項目を加える為に起動される｡ name は指定されている指示項目を含み､通常の X 形式では､名前 及び/又は 星印か点で区切られた級､から構成される｡ value は name と結合した文書文字列を含む; この値は Tk_GetOption への呼出し内で返される｡priority は値の優先権を指定する; 指示項目が Tk_GetOption を使用して待ち行列するとき､最高の優先権の値が返される｡priority は 0 と TK_MAX_PRIO (100) の間でなければならない｡幾つかの通常の優先度の値は次の通り: 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 (100). Some common priority values are:

TK_WIDGET_DEFAULT_PRIO (20)
  部品に入れたれた変更できない省略時設定値に使われる｡ Used for default values hard-coded into widgets.

TK_STARTUP_FILE_PRIO (40)
  応用譜固有の開始ファイル内に指定された指示項目に使われる｡ Used for options specified in application-specific startup files.

TK_USER_DEFAULT_PRIO (60)
  使用者固有の省略時設定ファイル内で指定された指示項目､譬えば .Xdefaults や､ X 中央集中処理装置内に組込まれた原資基礎データや､使用者固有の開始ファイル､に使われる｡ 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 (80)
  応用譜が実行開始した後に対話的に指定された指示項目に使われる｡ Used for options specified interactively after the application starts running.

### KEYWORDS

class, name, option, add
Copyright © 1998-2000 by Scriptics Corporation.