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

### 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_FontId, Tk_GetFontMetrics, Tk_PostscriptFontName — フォントの為の利用機能　 accessor functions for fonts
  SYNOPSIS
    #include <tk.h>
    Font
    Tk_FontId(tkfont)
    Tk_GetFontMetrics(tkfont, fmPtr)
    int
    Tk_PostscriptFontName(tkfont, dsPtr)
  引数 ARGUMENTS
    Tk_Font tkfont (入力in)
    Tk_FontMetrics *fmPtr (出力out)
    Tcl_DString *dsPtr (出力out)
  説明 DESCRIPTION
  データ構造 DATA STRUCTURES
  SEE ALSO
  KEYWORDS

### NAME

Tk_FontId, Tk_GetFontMetrics, Tk_PostscriptFontName — フォントの為の利用機能　 accessor functions for fonts

### SYNOPSIS

#include <tk.h>
Font
Tk_FontId(tkfont)
Tk_GetFontMetrics(tkfont, fmPtr)
int
Tk_PostscriptFontName(tkfont, dsPtr)

### 引数 ARGUMENTS

Tk_Font tkfont (入力in)
  問合されている不明瞭なフォント字句｡事前の Tk_GetFont への呼出しにより返されていなければならない｡　 Opaque font token being queried. Must have been returned by a previous call to Tk_GetFont.

Tk_FontMetrics *fmPtr (出力out)
  tkfont の為のフォント寸法情報が保存されている構造への指示子｡詳細は下の DATA STRUCTURES を参照されたい｡　 Pointer to structure in which the font metrics for tkfont will be stored. See DATA STRUCTURES below for details.

Tcl_DString *dsPtr (出力out)
  tkfont に相当するポストスクリプト字母の名前が追記されることになる初期化された Tcl_DString への指示子｡　 Pointer to an initialized Tcl_DString to which the name of the Postscript font that corresponds to tkfont will be appended.

### 説明 DESCRIPTION

Tk_FontId は tkfont を与えられ字句を返す､それは指定された文字形状で文書を描画する為に使われる画像状況を構成する為に XGCValues 構造に選択すべきである｡ Given a tkfont, Tk_FontId returns the token that should be selected into an XGCValues structure in order to construct a graphics context that can be used to draw text in the specified font.

Tk_GetFontMetrics は tkfont の文字高さ､深さ､行間距離､を画素単位で計算しそれらの値を fmPtr により指される構造内の値に保存する｡これらの値は､多行の文書の区間､異なる文字形状の文書の基準線の整列､与えられた領域内の文書の縦方向の揃えの様な計算に使うことができる｡文字形状測定基準内に使われる文字高さ､文字深さ､行間距離の用語の定義に就いては取扱説明書の font 命令を参照されたい｡ Tk_GetFontMetrics computes the ascent, descent, and linespace of the tkfont in pixels and stores those values in the structure pointer to by fmPtr. These values can be used in computations such as to space multiple lines of text, to align the baselines of text in different fonts, and to vertically align text in a given region. See the documentation for the font command for definitions of the terms ascent, descent, and linespace, used in font metrics.

Tk_PostscriptFontName は tkfont を､相当している印刷時に使われるべきポストスクリプト文字形状の名前に対応付けする｡返り値は tkfont のポイント単位の大きさであり､ポストスクリプト文字形状名が dsPtr に追記される｡ dsPtr は初期化された Tcl_DString を参照しなければならない｡“合理的な”ポストスクリプト印刷機を与えられ､次の画面文字形状一族は正しく印刷されるであろう: Tk_PostscriptFontName maps a tkfont to the corresponding Postscript font name that should be used when printing. The return value is the size in points of the tkfont and the Postscript font name is appended to dsPtr. DsPtr must refer to an initialized Tcl_DString. Given a “reasonable” Postscript printer, the following screen font families should print correctly:

  Avant Garde, Arial, Bookman, Courier, Courier New, Geneva, Helvetica, Monaco, New Century Schoolbook, New York, Palatino, Symbol, Times, Times New Roman, Zapf Chancery, and Zapf Dingbats.

その他のどの文字形状一族も正しく印刷されないかもしれない､理由は計算されたポストスクリプト文字形状名前は正しくないか印刷機上に実在しない｡ Any other font families may not print correctly because the computed Postscript font name may be incorrect or not exist on the printer.

### データ構造 DATA STRUCTURES

Tk_FontMetrics データ構造は Tk_GetFontMetrics によって文字形状に関する情報を返すために使われ､次の様に定義される: The Tk_FontMetrics data structure is used by Tk_GetFontMetrics to return information about a font and is defined as follows:

    typedef struct Tk_FontMetrics {
        int ascent;
        int descent;
        int linespace;
    } Tk_FontMetrics;

ascent 欄は､基準線から最も背の高い文字が上に伸上った画素単位の量に文字形状著者によって追加された余分の空白を加えた量である｡ The ascent field is the amount in pixels that the tallest letter sticks up above the baseline, plus any extra blank space added by the designer of the font.

descent は､基準線からどの文字でも下に下がりきった画素単位の量に文字形状著者によって追加された余分の空白を加えた量である｡ The descent is the largest amount in pixels that any letter sticks below the baseline, plus any extra blank space added by the designer of the font.

linespace は､文字高さと文字深さの合計である｡文書の同じ文字形状の二つの行がどれだけ離れて配置されれば一つの行のどの文字も別の行のどの文字にもかさならないかである｡ The linespace is the sum of the ascent and descent. How far apart two lines of text in the same font should be placed so that none of the characters in one line overlap any of the characters in the other line.

### SEE ALSO

font, MeasureChar

### KEYWORDS

font, measurement, Postscript
Copyright © 1996 Sun Microsystems, Inc.