## Tcl9.0.3/Tk9.0.3 Documentation > Tk C API > SetAppName

### 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_SetAppName — 'send'命令の為の応用譜の名前を設定する　 Set the name of an application for 'send' commands
  SYNOPSIS
    #include <tk.h>
    const char *
    Tk_SetAppName(tkwin, name)
  引数 ARGUMENTS
    Tk_Window tkwin (入力in)
    const char *name (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tk_SetAppName — 'send'命令の為の応用譜の名前を設定する　 Set the name of an application for 'send' commands

### SYNOPSIS

#include <tk.h>
const char *
Tk_SetAppName(tkwin, name)

### 引数 ARGUMENTS

Tk_Window tkwin (入力in)
  応用譜内の窓の字句結果｡特定の応用譜を選択する為にのみ使われる｡ Token for window in application. Used only to select a particular application.

const char *name (入力in)
  その応用譜の下で登録されている名前｡ Name under which to register the application.

### 説明 DESCRIPTION

Tk_SetAppName は､与えられた応用譜の名前と､応用譜の主窓を含む表示装置に結合した記録とを結合する｡この手続函数が起動された後､その展示上の他の応用譜は応用譜内の操作を起動する為に send 命令を使うことができるようになる｡もし名前が既に表示装置上のどれか他の応用譜によって使用中の場合､名前に “ #2” を追加して新しい名前が生成される;もしその名前もやはり使用中の場合､未使用の名前が見付るまで番号が増加される｡その手続函数からの返り値は実際に使われる名前へのポインタである｡ Tk_SetAppName associates a name with a given application and records that association on the display containing with the application's main window. After this procedure has been invoked, other applications on the display will be able to use the send command to invoke operations in the application. If name is already in use by some other application on the display, then a new name will be generated by appending “ #2” to name; if this name is also in use, the number will be incremented until an unused name is found. The return value from the procedure is a pointer to the name actually used.

Tk_SetAppName が呼ばれた時に応用譜が既に名前を有している場合､新しい名前が古い名前に置換わる｡ If the application already has a name when Tk_SetAppName is called, then the new name replaces the old name.

Tk_SetAppName も send 命令を応用譜の解釈実行機能に追加する､この応用譜から応用譜が窓を有する表示装置上の他のどれかの応用譜に命令を送る事ができる｡ Tk_SetAppName also adds a send command to the application's interpreter, which can be used to send commands from this application to others on any of the displays where the application has windows.

その応用譜の名前は解釈実行機能が削除されるか､解釈実行機能から send 命令が削除されるまで生残る､その時点に名前は自動的に登録抹消され､そして､応用譜は send 経由ででは利用不能になる｡その応用譜は呼出せば再度利用できるようにすることができる｡ The application's name registration persists until the interpreter is deleted or the send command is deleted from interp, at which point the name is automatically unregistered and the application becomes inaccessible via send. The application can be made accessible again by calling Tk_SetAppName.

Tk_SetAppName は自動的に Tk_Init,に呼ばれ､通常は応用譜が明示的に呼ぶ必要はない｡ Tk_SetAppName is called automatically by Tk_Init, so applications do not normally need to call it explicitly.

命令 tk appname は Tcl-水準での Tk_SetAppName の機能の利用を提供する｡ The command tk appname provides Tcl-level access to the functionality of Tk_SetAppName.

### KEYWORDS

application, name, register, send command
Copyright © 1994 The Regents of the University of California.
Copyright © 1994-1997 Sun Microsystems, Inc.