QCopメッセージ
QPE/Application/qshdlg
チャンネルまたは
/var/spool/qshdlg/control
PIPEでメッセージを受け付けます。
環境変数QSHDLG_APPをセットしている場合には
それぞれ
QPE/Application/$QSHDLG_APP
/var/spool/qshdlg/control_$QSHDLG_APP
になります。
ダイアログ制御
show()
ダイアログを表示します。
showMax()
ダイアログを最大化して表示します。
hide()
ダイアログを非表示にします。
reject()
Cancelボタンを押したときと同じ動作をします。
(ダイアログを閉じます)
done(int)
指定した値を返してダイアログを閉じます。
accept()
OKボタンを押した時と同じ動作をします。
cancel(QString)
Cancelボタンを押した時に、ダイアログ終了ではなく
指定した文字列を入力用PIPEに書き込むようにします。
ダイアログを終了するにはQCopメッセージreject()を使用して下さい。
title(QString)
ダイアログのタイトルを変更します。
message(QString)
下記を参照
description(QString)
ダイアログにメッセージを追加します。
message(QString)とdescription(QString)は全く同じ動作です。
richtext(QString)
リッチビューにテキストを追加します。
texttype(QString)
出力用パイプ
/var/spool/qshdlg/output
への書き込みをメッセージビュー、リッチビューのどちらに反映させるかを切り替えます。
出力先 | タイプ |
メッセージビュー | plain |
リッチビュー | rich |
clear()
ダイアログのメッセージをクリアします。
clearRich()
リッチビューをクリアします。
input(QString)
指定した文字列を入力します。
echo(int)
入力文字列をメッセージビューに表示するかどうかの設定を行います。
0 | 表示しない |
1 | 表示する |
font(QString,int)
フォントを変更します。
フォントファミリー名、ポイントサイズを指定します。
codec(QString)
コーデックを変更します。
コーデック名を指定します。
スクロール制御
scrollTop()
アウトプットビューの最上部にスクロールします。
scrollBottom()
アウトプットビューの最下部にスクロールします。
scrollAuto(int)
アウトプットビューにテキストが追加されたときに自動的にスクロールを行う/行わないの指定をします。
0 | オートスクロールしない |
1 | オートスクロール |
となります。
アクセラレータキー制御
setAccel(QString,QString)
アクセラレータキーをセットします。
"セットしたいキー"、"アクセラレータキーが押されたときに入力用PIPEに書き込む文字列"を指定します。
セットしたいキーはQAccel::stringToKey()で指定する文字列を使用して下さい。
参照
clearAccel()
上記のsetAccel()でセットしたアクセラレータキーを全て無効化します。
ウィジェット制御
size(int,int)
ダイアログのサイズを変更します。
指定する順番は、幅、高さの順です。
move(int,int)
ダイアログの位置を変更します。
指定する順番は、X座標、Y座標です。
※なぜかY座標はタイトルバーを含まない位置指定となっているようです。
フォーカス制御
focus(QString)
指定したコントロールにフォーカスをあてます。
対象コントロール | 識別子 |
インプットボックス | Input |
セレクトビュー | Select |
リプライボタン | Reply |
メッセージビュー | Message |
リッチビュー | Rich |
レイアウト制御
direction(QString,QString)
レイアウト変更の対象と、方向を指定します。
変更する対象 | 識別子 |
セレクトビューとメッセージビュー | View |
ビューとボタン | ViewButton |
リプライボタン | Buttom |
ビューとインプットボックス | ViewInput |
方向 | 識別子 |
左から右 | LeftToRight |
右から左 | RightToLeft |
上から下 | TopToBottom |
下から上 | BottomToTop |
例)
リプライボタンをビューの右に配置し、ボタンを縦に並べたい場合
direction(QString,QString) ViewButton LeftToRight direction(QString,QString) Button TopToBottom
メッセージビューとセレクトビューの表示位置を逆にしたい場合
direction(QString,QString) View BottomToTop
stretch(QString,int)
ウィジェットの伸長因子を変更します。伸長因子が大きいウィジェットがより多く伸長します。
ウィジェット | 識別子 |
メッセージビュー | message |
セレクトビュー | select |
例)
セレクトビューの方をより多く伸長させたい場合
stretch(QString,int) select 1
update()
ビューの内容に応じてレイアウトをアップデートします。
ビューに内容が追加されていないと伸長因子を変更しても比率は変更されないので、
ビューに内容を追加後、update()でレイアウトをアップデートすると比率が変更されます。
すでにビューに内容がセットされている場合には伸長因子の変更で比率が変更される場合もあります。
アイテム追加
下記のメッセージでアイテムを追加後、該当するコントロールを
showXXX()で表示するとアイテムがセットされます。
(ボタン、インプットボックス、およびリストボックスの初期化に使用します)
item(QString)
指定された値のアイテム(ラベル無し)を追加します。
item(QString,QString)
指定されたラベル、値のアイテムを追加します。
指定する順番は、ラベル、値の順です。
label(QString)
指定されたラベルのみで値の無いアイテム(選択不可能なリストアイテム)を追加します。
コントロール表示/非表示
showDefault()
デフォルトボタン(OK/Cancel)を表示します。
hideDefault()
デフォルトボタン(OK/Cancel)を非表示にします。
showMessage()
アウトプットビューを表示します。
hideMessage()
アウトプットビューを非表示にします。
showInput()
インプットボックスを表示します。
item(QString)で初期値を設定しておく事が可能です。
showPassword()
入力マスクのかかったインプットボックスを表示します。
hideInput()
インプットボックスを非表示にします。
showReply()
リプライボタンを表示します。
item(QString) または item(QString,QString) でボタンの値/ラベルを設定してから表示を行います。
item(QString)で 値の指定(値がそのままラベルとして表示)
item(QString,QSTring)で ラベルと値の指定を行う事が出来ます。
hideReply()
リプライボタンを非表示にします。
showSelect()
選択リストボックスを表示します。
item(QString),item(QString,QString),label(QString)でリストボックスの値/ラベルを設定してから表示を行います。
item(QString) で値の指定(値がそのままラベルとして表示)
item(QString,QString) でラベルと値の指定
label(QString) でラベルの指定(選択不可)を行う事が出来ます。
showMulti()
複数選択リストボックスを表示します。
hideSelect()
選択リストボックスを非表示にします。
showRich()
リッチビューを表示します。
hideRich()
リッチビューを非表示にします。