名称 NAME
  Label - 指示項目と､動的説明文と､引き摺り落し便益をを伴う札 Label widget with state option, dynamic help and drag and drop facilities

CREATION
  Label pathName ?option value...?

標準指示項目 STANDARD OPTIONS
Not themed

  -anchor
  | -background or -bg
  -bitmap
  | -borderwidth or -bd
  -cursor
  | -disabledforeground -font
  | -foreground or -fg
  -highlightbackground
  | -highlightcolor -highlightthickness
  | -image -justify
  | -padx -pady
  | -relief -takefocus
  | -text -textvariable
  | -wraplength

Themed

  -anchor
  | -background or -bg
  -cursor
  -font
  | -foreground or -fg | -image -justify
  -relief
  -takefocus
  | -text -textvariable
  | -wraplength

部品固有の指示項目 WIDGET-SPECIFIC OPTIONS

  -dragenabled
  | -dragendcmd -dragevent
  | -draginitcmd -dragtype
  | -dropcmd -dropenabled
  | -dropovercmd -droptypes
  | -focus -height
  | -helptext -helptype
  | -helpvar -name
  | -state -underline
  | -width

部品命令 WIDGET COMMAND
  pathName cget option
  pathName configure ?option? ?value option value ...?
  pathName setfocus

説明 DESCRIPTION

札部品は Tk 札を拡張する｡指示項目は札の状態に依存する､可視効果と､DynamicHelp指示項目と､Drag and Dropを提供する為に追加された｡ The Label widget extends the default Tk label. Options have been added to provide visual effect depending on the state of the Label, DynamicHelp options, and Drag and Drop.

部品固有の指示項目 WIDGET-SPECIFIC OPTIONS

-dragenabled
  引き摺りが可能か否かを示す論理値｡ A boolean specifying if drag is enabled.

-dragendcmd
  引き摺りが終了した時に呼ばれる命令を指定する｡DragSite::register の dragendcmd 指示項目に適合せねばならない｡ Specifies a command to be called when drag ended. dragendcmd must be a command conforming to the description of the option dragendcmd of DragSite::register.

-dragevent
  引き摺りに結合したマウス釦の番号を指定する｡1か2か3でなければならない｡ Specifies the number of the mouse button associated to the drag. Must be 1, 2 or 3.

-draginitcmd
  部品上で dragevent が生じる時､呼出される命令を指定する｡draginitcmd は DragSite::register の指示項目 draginitcmd の記述に適合する命令でなければならない｡ draginitcmd が空の場合､代りに内部 draginitcmd 命令が使われ帰る: Specifies a command to be called when dragevent occurs on widget. draginitcmd must be a command conforming to the description of the option draginitcmd of DragSite::register.
  If draginitcmd is empty, the internal draginitcmd command is used instead and returns:

    IMAGE {copy} <image name> | 影像が展示される場合｡ if an image is displayed.
    BITMAP {copy} <bitmap name> | 点地図が展示される場合｡ if a bitmap is displayed.
    TEXT {copy} <text> | 文書が展示される場合｡ if a text is displayed.

  dragtype 指示項目が空でない場合､上のものに換わってその値が使われる｡ Note that if dragtype option is not empty, its value is used instead of those above.

-dragtype
  引き摺られた対象の代りの型を指定する｡ Specifies an alternate type of dragged object.

-dropcmd
  部品上で落下が生じた時に呼出される命令を指す｡dropcmd は DropSite::register の dropcmd 指示項目の記述に適合しなければならない｡ dropcmd が空の場合､命令は次のデータの型に続く札を更新する: Specifies a command to be called when drop occurs on the widget. dropcmd must be a command conforming to the description of the option dropcmd of DropSite::register.
  If dropcmd is empty, the command updates the label following the type of the data:

    COLOR or FGCOLOR | 札の前景の再構成設定｡ reconfigure the foreground of the Label.
    BGCOLOR | 札の背景の再構成設定｡ reconfigure the background of the Label.
    IMAGE | 結合された映像を表示するべき札の再構成設定｡ reconfigure the Label to display the associated image.
    BITMAP | 結合された点地図を表示するべき札の再構成設定｡影像指示項目は空に設定される｡ reconfigure the Label to display the associated bitmap. image option is set to empty.
    TEXT, or any other tag | 結合された文字列を表示するべき札の再構成設定｡影像と点地図の指示項目は空に設定される｡ reconfigure the Label to display the associated string. image and bitmap options are set to empty.

  そして､1 を返す｡ and returns 1.

-dropenabled
  落下が可能か否かを示す論理値｡ 　 A boolean specifying if drop is enabled.

-dropovercmd
  引き摺りアイコンが部品上に懸かるときに呼出される命令を指定する｡dropovercmd 命令は DropSite::register の dropovercmd 指示項目の記述に適合していなければならない｡ もし､dropovercmd が空であると､データ型がFGCOLOR, COLOR, BGCOLOR及び state が通常の時の受容れ可能な全てのデータ型の場合には､札は常に落下を受容れる｡ Specifies a command to be called when drag icon is over the widget. dropovercmd must be a command conforming to the description of the option dropovercmd of DropSite::register.
  If dropovercmd is empty, Label always accepts the drop if data type is FGCOLOR, COLOR, BGCOLOR, and accepts all other data type only if state is normal.

-droptypes
  受容れられ落下される 対象/操作 のリストを指定する｡更なる情報はDropSite::register を参照されたい｡ 既定で FGCOLORと COLORとBGCOLOR と TEXT の全てを copy と move 操作と共に受容れる｡ Specifies a list of accepted dropped object/operation. See option droptypes of DropSite::register. for more infromation. Default accepts FGCOLOR, COLOR, BGCOLOR, TEXT, BITMAP and IMAGE, all with copy and move operations.

-focus
  経路名に Label::setfocus 命令に関する注目を設定する｡ Specifies a pathname to set the focus on for Label::setfocus command.

-height
  札に好ましい丈を指定する｡もし影像や点地図が札内に展示中の場合値は画像単位になる､文書では行単位になる｡もしこの指示項目が指定されていないと､札の望ましい丈はその中に表示中の映像か点地図か文書から算出される｡ themed 部品には指示項目が利用できない｡ Specifies a desired height for the label. If an image or bitmap is being displayed in the label then the value is in screen units, for text it is in lines of text. If this option isn't specified, the label's desired height is computed from the size of the image or bitmap or text being displayed in it.
  Option not available for themed widgets.

-helptext
  動的説明文の為の文書｡もし空ならこの部品については説明文は利用できない｡DynamicHelp を参照されたい｡ Text for dynamic help. If empty, no help is available for this widget. See also DynamicHelp.

-helptype
  動的説明文の様式｡balloon か variable を使用されたい｡ DynamicHelp をも参照されたい｡ Type of dynamic help. Use balloon or variable. See also DynamicHelp.

-helpvar
  helptype 指示項目が変数のときに使う変数｡ DynamicHelp をも参照されたい｡ Variable to use when helptype option is variable. See also DynamicHelp.

-name
  札についての標準名を指定する｡もし指示項目*nameName が原資基礎データ内に見付かると､text と underline 指示項目がその値から抽出される｡ Specifies a standard name for the label. If the option *nameName is found in the resource database, then text and underline options are extracted from its value.

-state
  札に関する二つの状態の内の一つを指定する: 通常 か 不能 ｡通常 状態では札の文書は 前景 指示項目を使って展示される｡不能状態では札の文書は 不能前景 指示項目を使って展示される｡ Specifies one of two states for the Label: normal or disabled. In normal state the text of the Label is displayed using the foreground option. In disabled state the text of the Label is displayed using the disabledforeground option.

-underline
  札内に下線を引くべき文字の整数番号位置を指定する｡0 は展示されている文書の最初の文字に相当し､1 は次の文字､以下続く｡ 束縛 <Alt-char> は Label::setfocus を呼ぶ札の頂上水準に自動的に設定される｡ Specifies the integer index of a character to underline in the label. 0 corresponds to the first character of the text displayed, 1 to the next character, and so on.
  The binding <Alt-char> is automatically set on the toplevel of the Label to call Label::setfocus.

-width
  札に好ましい巾を指定する｡もし影像や点地図が札内に展示中の場合値は画像単位になる､文書では文字単位になる｡もし指示項目が指定されていないと､札の望ましい巾はその中に表示中の映像か点地図か文書から算出される｡ Specifies a desired width for the label. If an image or bitmap is being displayed in the label then the value is in screen units, for text it is in characters. If this option isn't specified, the label's desired width is computed from the size of the image or bitmap or text being displayed in it.

部品命令 WIDGET COMMAND

pathName cget option
  option によって与えられる構成設定指示項目の現在の値が返る｡option は生成命令に受容れられるどのような値を採り得る｡ Returns the current value of the configuration option given by option. Option may have any of the values accepted by the creation command.

pathName configure ?option? ?value option value ...?
  部品の構成設定指示項目を問合せ又は修正する｡もしどの option も指定されないと､pathNameに関する利用できる全ての指示項目を記述するリストを返す｡もし option が value無しに指定されると､本命令は option と名付けられたものを記述するリストを返す(このリストはoptionが何も指定されない場合に返される値の対応する仔リストに等しくなる)｡もし､一つ或はそれ以上の option-value 対が指定されると､本命令は与えられた部品指示項目が与えらえた値を有するよう修正する; この場合､本命令は空文字列を返す｡option は生成命令によって受容れられるどのような値も採り得る｡読出し専用指示項目は修正されない｡ Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for pathName. If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the creation command. Read-only options are not be modified.

pathName setfocus
  -state が通常であれば､ -focus 指示項目によって与えられる経路名上に注目を設定する｡ Set the focus on the pathname given by -focus option if -state is normal.