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

### 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_GetGC, Tk_FreeGC — 読出し専用図面文脈の基礎データ維持 maintain database of read-only graphics contexts
  SYNOPSIS
    #include <tk.h>
    GC
    Tk_GetGC(tkwin, valueMask, valuePtr)
    Tk_FreeGC(display, gc)
  引数 ARGUMENTS
    Tk_Window tkwin (入力in)
    unsigned long valueMask (入力in)
    XGCValues *valuePtr (入力in)
    Display *display (入力in)
    GC gc (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tk_GetGC, Tk_FreeGC — 読出し専用図面文脈の基礎データ維持 maintain database of read-only graphics contexts

### SYNOPSIS

#include <tk.h>
GC
Tk_GetGC(tkwin, valueMask, valuePtr)
Tk_FreeGC(display, gc)

### 引数 ARGUMENTS

Tk_Window tkwin (入力in)
  図面文脈が使用される窓の為の字句｡ Token for window in which the graphics context will be used.

unsigned long valueMask (入力in)
  ビットの櫛(GCForeground や GCStippleの様な)であって適正な *valuePtr の欄を示している｡ Mask of bits (such as GCForeground or GCStipple) indicating which fields of *valuePtr are valid.

XGCValues *valuePtr (入力in)
  図面文脈の為の望ましい値を記述している構造への指示子｡ Pointer to structure describing the desired values for the graphics context.

Display *display (入力in)
  図面文脈が割当てられた表示器｡ Display for which gc was allocated.

GC gc (入力in)
  不要になった図面文脈の為の X 識別子｡以前 Tk_GetGC によって割当てられていなければならない｡　 X identifier for graphics context that is no longer needed. Must have been allocated by Tk_GetGC.

### 説明 DESCRIPTION

Tk_GetGC と Tk_FreeGC は応用譜に使われる絵画的状況の集積を管理する｡その手続函数は絵画的状況が共有されることを許容し､それでそれぞれの使用のために別々に絵画的状況が作成された場合に負う中央集中処理装置の負担を避ける｡Tk_GetGC は望ましい絵画的状況を記述する引数を取り､記述に適する絵画的状況の為の X 識別子を返す｡返される絵画的状況は valueMask と valuePtr により明示的に指定されなかった全ての欄内に省略時設定値を有する｡ Tk_GetGC and Tk_FreeGC manage a collection of graphics contexts being used by an application. The procedures allow graphics contexts to be shared, thereby avoiding the server overhead that would be incurred if a separate GC were created for each use. Tk_GetGC takes arguments describing the desired graphics context and returns an X identifier for a GC that fits the description. The graphics context that is returned will have default values in all of the fields not specified explicitly by valueMask and valuePtr.

Tk_GetGC はそれが作成した全てのTk_GetGC の基礎データを維持する｡何時であれ可能な時は､ Tk_GetGC への呼出しは､新しく作るよりも既存の絵画的状況を返す｡この接触は引続く中央集中処理装置の負担を減らす､そこで Tk_GetGC は一般に Xlib 手続函数 XCreateGC より優先的に使用されるべきであり､後者は､呼出しの度に新しい絵画的状況を作成する｡ Tk_GetGC maintains a database of all the graphics contexts it has created. Whenever possible, a call to Tk_GetGC will return an existing graphics context rather than creating a new one. This approach can substantially reduce server overhead, so Tk_GetGC should generally be used in preference to the Xlib procedure XCreateGC, which creates a new graphics context on each call.

Tk_GetGC は共有されている為､呼出し側は Tk_GetGC に返された絵画的状況を修正してはならない｡もし絵画的状況が動的に修正されなければならない場合､それは Tk_GetGC の代りに XCreateGC 呼出しによって作られるべきである｡ Since the return values of Tk_GetGC are shared, callers should never modify the graphics contexts returned by Tk_GetGC. If a graphics context must be modified dynamically, then it should be created by calling XCreateGC instead of Tk_GetGC.

絵画的状況が最早必要なくなる時､それを解放する為に Tk_FreeGC が呼出されるべきである｡それぞれの Tk_GetGC 呼出しに対し､厳密に１度の Tk_FreeGC 呼出があるべきである｡絵画的状況がどこにも使われなくなった時(即ち､それが得られた回数と同じ回数解消された)､ Tk_FreeGC がそれを X 中央集中処理装置に解放し､基本データから削除する｡ When a graphics context is no longer needed, Tk_FreeGC should be called to release it. There should be exactly one call to Tk_FreeGC for each call to Tk_GetGC. When a graphics context is no longer in use anywhere (i.e. it has been freed as many times as it has been gotten) Tk_FreeGC will release it to the X server and delete it from the database.

### KEYWORDS

graphics context
Copyright © 1990 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.