MQEditクラス

(new in Rev4.00)

MQEdit クラスは文字列・数値を入力するウィジェットを管理します。MQWidgetBaseクラスを継承しています。

継承元クラスで定義されるメンバ関数はそのクラスの記述を参照してください。

クラス
MQEdit コンストラクタ
~MQEdit デストラクタ
メンバ関数
GetText 表示文字列の取得
SetText 表示文字列の設定
GetFontName フォント名の取得
SetFontName フォント名の設定
GetFontBold 太字フォントの取得
SetFontBold 太字フォントの設定
GetFontScale 文字の表示拡大率の取得
SetFontScale 文字の表示拡大率の設定
GetReadOnly 読み込み専用の取得
SetReadOnly 読み込み専用の設定
GetPassword パスワード入力モードの取得
SetPassword パスワード入力モードの設定
GetAlignment 文字の配置位置の取得
SetAlignment 文字の配置位置の設定
GetNumeric 数値モードの取得
SetNumeric 数値モードの設定
GetMaxLength ワイド文字数上限の取得
SetMaxLength ワイド文字数上限の設定
GetMaxAnsiLength ANSI文字数上限の取得
SetMaxAnsiLength ANSI文字数上限の設定
GetVisibleColumn 表示文字数の取得
SetVisibleColumn 表示文字数の設定
SetFocus フォーカスの設定
イベント
AddChangedEvent 文字列が変更された時のイベントを追加
AddChangingEvent 文字列を変更中のイベントを追加

MQEdit::MQEdit();

MQEdit::MQEdit(int id);

id
プラグイン外で生成されたウィジェットのID

コンストラクタです。


virtual MQEdit::~MQEdit();

デストラクタです。仮想関数として定義されます。


std::wstring MQEdit::GetText();

戻り値
表示文字列

入力欄に表示される文字列を取得します。


void MQEdit::SetText(const std::wstring& text);

text
表示文字列

入力欄に表示される文字列を設定します。


std::wstring MQEdit::GetFontName();

戻り値
フォント名

文字を表示するフォントを取得します。


void MQEdit::SetFontName(const std::wstring& value);

value
フォント名

文字を表示するフォントを設定します。


bool MQEdit::GetFontBold();

戻り値
太字設定

文字を太字で表示するかどうかを取得します。


void MQEdit::SetFontBold(bool value);

value
太字設定

文字を太字で表示するかどうかを設定します。


double MQEdit::GetFontScale();

戻り値
文字の表示拡大率

標準フォントサイズに対する比率で文字の表示拡大率を取得します。

デフォルト値は1.0です。


void MQEdit::SetFontScale(double value);

value
文字の表示拡大率

標準フォントサイズに対する比率で文字の表示拡大率を設定します。


bool MQEdit::GetReadOnly();

戻り値
読み込み専用

読み込み専用にしてキー操作による文字入力を受け付けないかどうかを取得します。


void MQEdit::SetReadOnly(bool value);

value
読み込み専用

読み込み専用にしてキー操作による文字入力を受け付けないかどうかを設定します。


bool MQEdit::GetPassword();

戻り値
パスワードモード設定

文字を * マークに置き換えて表示するかどうかを取得します。


void MQEdit::SetPassword(bool value);

value
パスワードモード設定

文字を * マークに置き換えて表示するかどうかを設定します。


MQEdit::MQEditTextAlignment MQEdit::GetAlignment();

戻り値
文字の配置位置
[ALIGN_LEFT]
[ALIGN_CENTER] 中央
[ALIGN_RIGHT]

文字を表示する位置を取得します。


void MQEdit::SetAlignment(MQEditTextAlignment value);

value
文字の配置位置
[ALIGN_LEFT]
[ALIGN_CENTER] 中央
[ALIGN_RIGHT]

文字を表示する位置を設定します。


MQEdit::MQEditNumericType MQEdit::GetNumeric();

戻り値
数値モード
[NUMERIC_TEXT] 文字列
[NUMERIC_INT] 整数
[NUMERIC_DOUBLE] 実数

数値の入力モードを取得します。

整数・実数モードが指定された場合、数値以外の文字の入力が制限されます。


void MQEdit::SetNumeric(MQEditNumericType value);

value
数値モード
[NUMERIC_TEXT] 文字列
[NUMERIC_INT] 整数
[NUMERIC_DOUBLE] 実数

数値の入力モードを設定します。

整数・実数モードが指定された場合、数値以外の文字の入力が制限されます。


int MQEdit::GetMaxLength();

戻り値
文字数上限

入力可能な最大文字数を取得します。

文字数はワイド文字単位でカウントされます。0が指定された場合、上限はありません。


void MQEdit::SetMaxLength(int value);

value
文字数上限

入力可能な最大文字数を設定します。

文字数はワイド文字単位でカウントされます。0が指定された場合、上限はありません。


int MQEdit::GetMaxAnsiLength();

戻り値
文字数上限

入力可能な最大文字数を取得します。

文字数はシステムで定義されたANSI文字単位でカウントされます。0が指定された場合、上限はありません。


void MQEdit::SetMaxAnsiLength(int value);

value
文字数上限

入力可能な最大文字数を設定します。

文字数はシステムで定義されたANSI文字単位でカウントされます。0が指定された場合、上限はありません。


int MQEdit::GetVisibleColumn();

戻り値
横幅内に表示可能な文字数

横幅を計算するための文字数を取得します。


void MQEdit::SetVisibleColumn(int value);

value
横幅内に表示可能な文字数

横幅を計算するための文字数を設定します。

SetHorzLayout()でLAYOUT_AUTOが指定されている場合、指定された文字数が横幅内に表示されるよう横幅が計算されます。ただし、プロポーショナルフォントの場合、文字によって横幅が異なるため、必ずしも指定した文字数が横幅内に表示されるとは限りません。


void MQEdit::SetFocus(bool value);

value
フォーカス状態

フォーカス状態を設定します。

フォーカス状態になっている場合に、このウィジェットへキーボードメッセージが通知されます。

trueを指定した場合、既に他のウィジェットがフォーカス状態になっていればフォーカスはそのウィジェットからこのウィジェットに移動します。


template<typename T> void MQEdit::AddChangedEvent(T *p, BOOL (T::*f)(MQWidgetBase*, MQDocument), bool prior = false)

p
イベント通知先のウィジェット
f
イベント通知先のメンバ関数
prior
イベントの通知順序
[true] 最初に通知されるよう指定
[false] 最後に通知されるよう指定

ユーザーの操作により文字列が変更されたときに発生されるイベントを追加します。

キー入力により文字列が編集されたときにAddChangingEvent()が、Enterキーが押されたりTabキーやマウス操作によって他のウィジェットへフォーカスが移動したときにAddChangedEvent()が発生します。


template<typename T> void MQEdit::AddChangingEvent(T *p, BOOL (T::*f)(MQWidgetBase*, MQDocument), bool prior = false)

p
イベント通知先のウィジェット
f
イベント通知先のメンバ関数
prior
イベントの通知順序
[true] 最初に通知されるよう指定
[false] 最後に通知されるよう指定

ユーザーの操作により文字列が変更されている最中に発生されるイベントを追加します。

キー入力により文字列が編集されたときにAddChangingEvent()が、Enterキーが押されたりTabキーやマウス操作によって他のウィジェットへフォーカスが移動したときにAddChangedEvent()が発生します。