DLGGET, DLGGETINT, DLGGETLOG, DLGGETCHAR

実行時関数:ダイアログ・コントロール変数の状態を取り出します。

モジュールUSE DFLOGM

形式

result = DLGGET (dlg, controlid, value [, index])
result = DLGGETINT (dlg, controlid, value [, index])
result = DLGGETLOG (dlg, controlid, value [, index])
result = DLGGETCHAR (dlg, controlid, value [, index])

dlg
(入力) 構造型 DIALOG。ダイアログボックス・パラメタを含みます。構造型 DIALOG の成分は,PRIVATE 属性で定義され,ユーザーが変更したり,個別に参照することはできません。

controlid
(入力) 整数型。ダイアログボックス内のコントロールの識別子を指定します。コントロールに対するシンボル名または識別子番号のどちらでも指定することができます。両方ともインクルード・ファイル (.FD 拡張子) に一覧表示されています。

value
(出力) 整数型,論理型,または文字型。コントロール変数の値。

index
(省略可能,入力) 整数型。値を取り出したいコントロール変数を指定します。コントロールが同じデータ型の複数の変数を持つ場合やその型の基本値を取り出したくない場合には必要です。

結果

結果の型は LOGICAL(4) です。成功すれば .TRUE. が返され,そうでなければ .FALSE. が返されます。

ダイアログボックス・コントロールに関連した変数値を取り出すには,DLGGET 関数を使用します。各コントロールは,それに関連した整数型,論理型,または文字型の変数を少なくとも 1 つは持っていますが,すべてを必要とするわけではありません。コントロール変数は,「コントロール指標」の表に一覧表示されています。関連するコントロールの型は,「個々のダイアログ・コントロールで使用できる指標」の表に一覧表示されています。

変数値を取り出すために DLGGET を使用することができます。整数値を取り出すために DLGGETINT を,論理値を取り出すために DLGGETLOG を,文字値を取り出すために DLGGETCHAR を使うこともできます。DLGGET を使う場合,変数型に関数が一致するかどうかを心配する必要はありません。変数に対して間違った関数型を使用した場合や利用不可な変数型を取り出そうとした場合,DLGGET 関数は .FALSE. を返します。

2 つ以上のコントロールが同じ controlid を持つ場合,これらのコントロールを DLGGET 操作で使用することはできません。この場合,関数は .FALSE. を返します。

ダイアログボックスのコントロール変数を参照する為に,ダイアログボックスを開く必要はありません。

互換性

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

関連情報

DLGINITDLGMODALDLGMODELESSDLGSETDLGSETSUB

	USE DFLOGM
	INCLUDE "THISDLG.FD"
	TYPE (DIALOG)  dlg
	INTEGER        val
	LOGICAL        retlog, is_checked
	CHARACTER(256) text
	...
	retlog = DLGGET (dlg, IDC_CHECKBOX1, is_checked, dlg_status)
	retlog = DLGGET (dlg, IDC_SCROLLBAR2, val, dlg_range)
	retlog = DLGGET (dlg, IDC_STATIC_TEXT1, text, dlg_title)
	...