|
|
QMultiLineEdit ウィジェットはテキストを入力するための簡単なエディタです。 詳細...
#include <qmultilineedit.h>
スーパークラス : QTableView
| Type | Name | READ | WRITE | Options |
|---|---|---|---|---|
| int | numLines | numLines | ||
| bool | atBeginning | atBeginning | ||
| bool | atEnd | atEnd | ||
| int | maxLineWidth | maxLineWidth | ||
| Alignment | alignment | alignment | setAlignment | |
| bool | edited | edited | setEdited | DESIGNABLE false |
| EchoMode | echoMode | echoMode | setEchoMode | |
| int | maxLength | maxLength | setMaxLength | |
| int | maxLines | maxLines | setMaxLines | |
| int | hMargin | hMargin | setHMargin | |
| WordWrap | wordWrap | wordWrap | setWordWrap | |
| int | wrapColumnOrWidth | wrapColumnOrWidth | setWrapColumnOrWidth | |
| WrapPolicy | wrapPolicy | wrapPolicy | setWrapPolicy | |
| bool | autoUpdate | autoUpdate | setAutoUpdate | DESIGNABLE false |
| bool | undoEnabled | isUndoEnabled | setUndoEnabled | |
| int | undoDepth | undoDepth | setUndoDepth | |
| bool | readOnly | isReadOnly | setReadOnly | |
| bool | overWriteMode | isOverwriteMode | setOverwriteMode | |
| QString | text | text | setText | |
| int | length | length |
QMultiLineEdit ウィジェットはテキストを入力するための簡単なエディタです。
QMultiLineEdit ウィジェットは複数行のテキストの入力と表示を提供します。 これは大量のテキストの編集に向いています。 機能に制限はありませんが、メガバイト単位のデータを扱おうとするとパフォーマンスに影響が出るでしょう。
デフォルトでは、エディタウィジェットは折り返しを行いません。 これは setWordWrap() で調整することができます。 表示可能な幅、固定文字数、固定ピクセル数での動的折り返しがサポートされています。
このウィジェット setReadOnly(TRUE) を呼び出すことでテキストを表示するのに使えます。
デフォルトのキーバインディングは keyPressEvent() で記述されています。 クラスを継承する以外にこれをカスタマイズする方法はありません。
例 mainlyQt/editor.cpp layout/layout.cpp mainlyXt/editor.cpp mainlyMotif/editor.cpp rot13/rot13.cpp scrollview/scrollview.cpp customlayout/main.cpp
この列挙型は QLineEdit が内容を表示する方法を記述します。 現在定義されている値は :
Normal - 入力された文字をそのまま表示する。これがデフォルト。
NoEcho - 何も表示しない。
Password - 実際に入力された文字の代わりにアスタリスクを表示する。
setEchoMode(), echoMode(), QLineEdit::EchoMode もご覧ください。
この列挙型はマルチラインエディットのワードラップモードを記述します。
以下の値が利用できます :
NoWrap - 全く折り返さない
WidgetWidth - 現在のウィジェットの幅に応じて折り返す
FixedPixelWidth - 一定のピクセル値で折り返す ( wrapColumnOrWidth() を参照)
FixedColumnWidth - 一定の文字数で折り返す。
固定スペースフォントのデバイス (例えば標準 VT100 端末)
にきれいに表示できるようにフォーマットされたテキストが必要な場合に、これが役に立ちます。
この場合、通常 wrapColumnOrWidth() は 80 に設定されます。
setWordWrap() もご覧ください。
ワードラップモードのときにどこでテキストを改行できるかを定義します。
以下の値が有効です :
AtWhiteSpace - 空白の後でのみ改行する
Anywhere - どこでも改行する
setWrapPolicy() もご覧ください。
空の QMultiLineEdit を作成します。
QMultiLineEdit を破棄します。
アラインメントを返します。
setAlignment(), Qt::AlignmentFlags もご覧ください。
[slot]テキストの末尾に s を追加します。
カーソルがテキストの先頭にあれば TRUE を返します。
カーソルがテキストの末尾にあれば TRUE を返します。
ビューが変更されると、自動的にビューが自分自身を更新するようになっていれば TRUE を返します。
setAutoUpdate() もご覧ください。
[virtual protected]カーソルの左側の文字を削除し、カーソルを一つ左に移動させます。 テキストがユーザーによって (クリックやドラッグなどで) 選択されていた場合、 カーソルは選択されていたテキストの先頭に移動し、選択されていたテキストが削除されます。
del() もご覧ください。
[slot]すべてのテキストを削除します。
[slot]選択されているテキストをクリップボードにコピーします。 echoMode() が Normal である場合にのみコピーが行われます。
[signal]このシグナルは、切り取り/コピーが利用できるようになったとき、または利用できなくなったときに発生します。 yes が TRUE の場合、次に copyAvailable( FALSE ) が発生するまで cut() と copy() が利用できます。
[slot]新しいコードではこの関数を使用しないことを強くお勧めします。
後方互換性のために残されています。
[virtual protected]カーソルを 1 行下に移動させます。 mark が TRUE の場合テキストが選択されます。
cursorUp(), cursorLeft(), cursorRight() もご覧ください。
[virtual protected]カーソルを 1 文字右に移動させます。mark が TRUE の場合テキストが選択されます。 wrap が TRUE の場合、カーソルが行の先頭に合った場合に前の行の末尾に移動します。
cursorRight(), cursorUp(), cursorDown() もご覧ください。
[protected]カーソルが描画されている位置の上端中央の点を返します。
新しいコードではこの関数を使用しないことを強くお勧めします。
代わりに getCursorPosition() を使ってください。
[virtual protected]カーソルを 1 文字右に移動させます。mark が TRUE の場合テキストが選択されます。 wrap が TRUE の場合、カーソルが行の末尾に合った場合に次の行の先頭に移動します。
cursorLeft(), cursorUp(), cursorDown() もご覧ください。
[virtual protected]カーソルを 1 行上に移動させます。 mark が TRUE の場合テキストが選択されます。
cursorDown(), cursorLeft(), cursorRight() もご覧ください。
カーソルを 1 語左に移動させます。 mark が TRUE の場合テキストが選択されます。
cursorWordForward() もご覧ください。
カーソルを 1 語右に移動させます。 mark が TRUE の場合テキストが選択されます。
cursorWordBackward() もご覧ください。
[slot]選択されているテキストをクリップボードにコピーし、そのテキストを削除します。
[static]タブストップ間の距離を返します。
setDefaultTabStop(); もご覧ください。
[virtual protected]テキストカーソルの右側の文字を削除します。 テキストがユーザーによって (クリックやドラッグなどで) 選択されていた場合、 カーソルは選択されていたテキストの先頭に移動し、選択されていたテキストが削除されます。
backspace() もご覧ください。
[slot]すべてのテキストの選択を解除します。カーソルの位置は変更されません。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
現在設定されているエコーモードを返します。
setEchoMode() もご覧ください。
このラインエディットの編集済みフラグを返します。 この関数が FALSE を返した場合、 QMultiLineEdit が作成されてから (または最後に setEdited( FALSE ) が呼び出されてから) 内容が変更されていません。 この関数が TRUE を返した場合、内容が変更されたか setEdited( TRUE ) が呼び出されました。
setEdited() もご覧ください。
[virtual protected]カーソルを行の右端に移動させます。 mark が TRUE の場合、行の右端までテキストが選択されます。 mark が FALSE でカーソルが移動した場合、選択されていたすべてのテキストの選択が解除されます。
home() もご覧ください。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QObject からの再実装です。
[virtual protected]カーソルの点滅を開始します。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
現在の行とその行内での文字位置をそれぞれ line と col が指す変数に返します。
setCursorPosition() もご覧ください。
[protected]選択されているテキストがある場合、 line1, col1, line2, col2 を選択されている領域の始点と終点に設定し、TRUE を返します。 選択されているテキストがない場合 FALSE を返します。
[protected]行 line のテキストへのポインタを返します。
現在設定されている水平マージンを返します。デフォルトは 3 です。
setHMargin() もご覧ください。
[protected]選択されているテキストがあれば TRUE を返します。
[virtual protected]カーソルを行の左端に移動させます。 mark が TRUE の場合、行の左端までテキストが選択されます。 mark が FALSE でカーソルが移動した場合、選択されていたすべてのテキストの選択が解除されます。
end() もご覧ください。
[slot]現在のカーソルの位置に s を挿入します。
[virtual protected]現在のカーソルの位置に c を挿入します。
[virtual]行番号 line の文字番号 col の後に txt を挿入します。 txt が改行文字を含んでいる場合、新しい行が挿入されます。
カーソルの位置が調整されます。 カーソルの位置に文字列が挿入された場合、カーソルは挿入された文字列の末尾の後に移動します。
[protected]現在のカーソル位置に c を挿入します (この関数は後方互換性のために提供されます。これは insert() を呼び出すだけです)。
[virtual]行番号 line に txt を挿入します。 line が 0 より小さいか行数より大きい場合、新しいテキストは末尾に挿入されます。 txt が改行文字を含んでいる場合、複数の行が挿入されます。
カーソルの位置は変更されません。
[protected]row が段落の最後の行であるかどうかを返します。
この関数はワードラップモードでのみ意味があります。 そうでない場合返り値は必ず TRUE になります。
setWordWrap() もご覧ください。
このマルチラインエディットが上書きモード、 つまり入力された文字がエディタ内の文字を置き換えるようになっていれば TRUE を返します。
setOverwriteMode() もご覧ください。
このマルチラインエディットがテキスト入力を受けつけるならば FALSE を返します。 スクロールとカーソルの移動は常に可能です。
setReadOnly(), QWidget::isEnabled() もご覧ください。
このマルチラインエディットで現在アンドゥが可能であるかどうかを返します。
setUndoEnabled() もご覧ください。
[virtual protected]このキープレスイベントハンドラはキープレスをラインエディタアクションに変換します。
以下は isReadOnly() が FALSE である場合のデフォルトのキーバインディングです :
以下は isReadOnly() が TRUE である場合のデフォルトのキーバインディングです :
QWidget からの再実装です。
[virtual protected]現在のカーソル位置から行の末尾までのテキストを削除します。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
現在のテキストの長さを返します。
setMaxLength() もご覧ください。
[protected]行番号 line の行に含まれる文字の数を返します。
[protected]選択されているテキストのコピーを返します。
現在設定されているテキストの長さの制限を返します。 制限がなければ -1 を返します (これがデフォルトです)。
setMaxLength() もご覧ください。
現在設定されている行の長さの制限を返します。 制限がなければ -1 を返します (これがデフォルトです)。
setMaxLineLength() もご覧ください。
このエディタの中で最も長い行の幅をピクセル単位で返します。
現在設定されている行数の制限を返します。 制限がない (デフォルト) 場合 -1 を返します。
setMaxLines() もご覧ください。
[virtual]1 文字とスクロールバーを表示するのに十分なサイズを返します。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual protected]現在のカーソル位置で改行します。
エディタ内の行数を返します。 一番上または一番下にある空の行も数えられます。 そのため、空のエディタではこのメソッドは 1 を返します。
[virtual protected]カーソルを 1 ページ下に移動させます。 mark が TRUE の場合、テキストが選択されます。
[virtual protected]カーソルを 1 ページ上に移動させます。 mark が TRUE の場合、テキストが選択されます。
[virtual protected]基本的な描画ロジックを実装しています。
QTableView からの再実装です。
[slot]クリップボードから現在のカーソル位置にプレインテキストをコピーします。 選択されていたテキストは削除されます。
[slot]クリップボードから現在のカーソル位置に MIME サブタイプ subtype のテキストをコピーします。 選択されていたテキストは削除されます。
[slot]最後のテキスト操作をもう一度行います。
[signal]このシグナルはリドゥが利用できるかどうかが変化したときに発生します。 yes が TRUE である場合、次に redoAvailable( FALSE ) が発生するまで redo() が利用できます。
[virtual]行番号 line の行を削除します。 line が 0 より小さいか行数より大きい場合、どの行も削除されません。
[virtual protected]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[signal]このシグナルは、ユーザーが Return/Enter キーを押したときに発生します。 isReadOnly() が TRUE の場合は発生しません。
textChanged() もご覧ください。
[slot]カーソルを移動せずに、すべてのテキストを選択します。
アラインメントを設定します。
指定できる値は AlignLeft, Align(H)Center, AlignRight です。
alignment(), Qt::AlignmentFlags もご覧ください。
[virtual]この QMultiLineEdit 自動更新オプションを enable に設定します。
enable が TRUE (デフォルト) の場合、 エディタは内容が変更されると (一般にテキストが挿入または削除されると) 自動的に更新されます。
enable が FALSE の場合、ビューは自分自身を再描画せず、 ビューが変更されても内部状態変数を更新しません。 これは、大量の変更を行う場合にちらつきを防ぐために役に立ちます。 つまり、自動更新を無効にして変更を行い、自動更新を有効に戻し、repaint() を呼び出します。 それ以外の場合は特に役に立ちません。
注意 : 長い間 (イベントが複数回発生する間) ビューの自動更新を無効にしておかないでください。 例えば、自動更新が無効であるときにユーザーがビューを操作すると、おかしな事が起きます。
自動更新を TRUE に設定するとすぐにビューが再描画されるわけではありません。 再描画を行うには repaint() (ちらつきを防ぐため repaint(FALSE) が望ましい) を呼び出す必要があります。
autoUpdate(), repaint() もご覧ください。
[virtual]カーソルの位置を行番号 line の文字番号 col に設定します。 引数は正しい範囲に入るように調整されます。
mark が FALSE の場合、選択が消去されます。 TRUE の場合、選択が拡張されます。
cursorPosition() もご覧ください。
[static]すべての QMultiLineEdit インスタンスのタブストップの長さを ex に設定します。 この値は、ウィジェットのフォントでの小文字の 'x' の幅の倍数で表されます。 初期値は 0 です。
_warn この関数は再描画を行いません。 QMultiLineEdit ウィジェットが表示される前にこの関数を呼び出すのが良いでしょう。
defaultTabStop() もご覧ください。
エコーモードを em に設定します。デフォルトは Normal です。
表示が更新されます。
setEchoMode() もご覧ください。
この QMultiLineEdit の編集済みフラグを on に設定します。 編集済みフラグはこの QMultiLineEdit によって読み取られることはありません。 ユーザーが QMultiLineEdit の内容を変更すると TRUE に設定されます。
例えばこの関数は、デフォルト値を提供したいけれども、 すぐにはデフォルト値を決めることができない場合に便利です。 この場合、デフォルト値を決めずにラインエディットを作成し、 デフォルト値が分かった時点でedited() の戻り値を確認して、 ユーザーがラインエディットを編集していなければ、 ラインエディットの内容を設定します。 別の例としては、内容を保存する必要があるかどうかを確認する場合に使われます。
edited() もご覧ください。
[virtual]現在のフォントで lines 行のテキストを表示できるように、 QMultiLineEdit の高さを設定します。
setMaxLines(), setFixedHeight() もご覧ください。
[virtual]内部の事情による再実装です。API には影響ありません。
[virtual]水平マージンを設定します。
hMargin() もご覧ください。
テキストの最大の長さを m に設定します。 無制限 (デフォルト) にするには -1 を使います。 既存の最大長さを越えるテキストは切りつめられます。
maxLength() もご覧ください。
[virtual]行の最大の長さを m に設定します。 無制限 (デフォルト) にするには -1 を使います。 既存の最大長さを越える行は切りつめられます。
maxLineLength() もご覧ください。
[virtual]最大の行数を m に設定します。 無制限 (デフォルト) にするには -1 を使います。 最大の行数を越えるテキストは削除されます。
最大の行数を越えるテキストはテキストの 末尾 から削除されます。 先頭 から削除されるテレタイプのような動作にしたい場合、 最大の行数を越えるテキストを追加する前に removeLine(0) を呼び出します。
maxLines(), numLines() もご覧ください。
[virtual slot]on が TRUE の場合上書きモードを設定します。 上書きモードは入力された文字がエディタ内の文字を置き換えることを意味します。
isOverwriteMode() もご覧ください。
[virtual slot]on が FALSE の場合、この QMultiLineEdit がテキスト入力を受け付けます。 スクロールとカーソル移動は常に可能です。
isReadOnly(), QWidget::setEnabled() もご覧ください。
[virtual]row_from, col_from から row_to, col_to までのテキストを選択します。
[virtual slot]テキストを s に設定します。以前のテキストは (もしあれば) 削除されます。
例 mainlyQt/editor.cpp layout/layout.cpp mainlyXt/editor.cpp mainlyMotif/editor.cpp scrollview/scrollview.cpp customlayout/main.cpp
アンドゥスタックに保持できる操作の最大の数を設定します。
undoDepth() もご覧ください。
enable にしたがってアンドゥが可能かどうかを設定します。
isUndoEnabled() もご覧ください。
[virtual]現在はサポートされていません。
ワードラップモードを設定します。
デフォルトでは、ラッピングは単語を維持します。
単語の中での改行を許可するには、ラップポリシー を Anywhere に設定します (setWrapPolicy() 参照)。
デフォルトのラップモードは NoWrap です。
wordWrap(), setWrapColumnOrWidth(), setWrapPolicy() もご覧ください。
ワードラップモードによって、ラップカラムまたはラップ行を設定します。
setWordWrap() もご覧ください。
ワードラップモードのときにどこでテキストを改行することができるかを定義します。
デフォルトは AtWhiteSpace です。
setWordWrap(), wrapPolicy() もご覧ください。
[virtual]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[virtual]内部の事情による再実装です。API には影響ありません。
QWidget からの再実装です。
[protected]行 row に表示されている文字列を返します。echoMode() の処理も含まれます。
テキスト全体をコピーします。 この QMultiLineEdit がテキストを含んでいない場合 null 文字列 が返されます。
[signal]このシグナルは、イベントまたはスロットによってテキストが変更されたときに発生します。 このシグナルは insertLine() などのスロットでない関数を呼び出したときには発生しないことに注意してください。
returnPressed() もご覧ください。
行番号 line のテキストを返します (空文字列であることもあります)。 line が無効な場合 null 文字列 を返します。
[protected]文字列 s の幅をピクセル単位で返します。 注意 : 行全体に対してのみ有効です。
[protected]行 line のテキストの幅をピクセル単位で返します。
[virtual protected]内部の事情による再実装です。API には影響ありません。 バイナリ互換性のためだけに提供されています。
QObject からの再実装です。
[slot]最後のテキスト操作を取り消します。
[signal]このシグナルはアンドゥが利用できるかどうかが変化したときに発生します。 yes が TRUE の場合、次に undoAvailable( FALSE ) が発生するまで undo() を利用することができます。
アンドゥスタックに保持できる操作の最大の数を返します。
setUndoDepth() もご覧ください。
現在はサポートされていません。
[virtual protected]内部の事情による再実装です。API には影響ありません。 ホイールイベントを垂直スクロールバーに渡します。
QWidget からの再実装です。
現在のワードラップモードを返します。
setWordWrap() もご覧ください。
ワードラップモードによって、ラップカラムまたはラップ行を返します。
setWordWrap(), setWrapColumnOrWidth() もご覧ください。
現在のワードラップポリシーを返します。
setWrapPolicy() もご覧ください。
Search the documentation, FAQ, qt-interest archive and more (uses
www.trolltech.com):
This file is part of the Qt toolkit, copyright © 1995-2001 Trolltech, all rights reserved.
| Copyright © 2001 Trolltech | Trademarks | Qt version 2.3.2
|