TMaskEdit/ja

From Lazarus wiki
Jump to navigationJump to search

English (en) français (fr) 日本語 (ja) русский (ru)

A TMaskEdit tmaskedit.png は'編集マスク'に適合するように編集できる1行テキストを持つコントロールである。Component Palette/jaAdditional tab/jaにある

編集マスクプロパティ

編集マスクは3つのフィールドよりなり、それぞれがMaskFieldSeparator文字(デフォルトはセミコロン(';'))である。

フィールド 意味 必須か否か
実際のマスク 文字列 テキストが適合すべき実際のパターン はい
マスク保存 記号 実際のマスクのテキストプロパティが含むリテラル文字があるか否かのコントロール。'0'以外の値はリテラル文字が含まれる いいえ
スペース文字 記号 TMaskEditがからの時に示される記号デフォルトは'_' いいえ


実際のマスクは以下の意味を持つ文字のパターンからなる:

記号 ユーザーにより入力されうる文字 Delphi互換性
cMask_SpecialChar \ これの後に任意の記号を設定できる (例えば'P\a' => 'Pa')
cMask_LowerCase < これの後は小文字になる
cMask_UpperCase > これの後は大文字になる。 文字列<>は小文字- もしくは大文字の終わりを強制することに注意
cMask_Letter l 1つの文字のみしかし必要ではない
cMask_LetterFixed L 1つの文字のみ (任意!)
cMask_AlphaNum a 1つのアルファベットおよび数字(['A'..'Z','a..'z','0'..'9']) しかし必要ではない
cMask_AlphaNumFixed A 1つのアルファベットおよび数字(任意!)
cMask_AllChars c いずれかのUtf8文字しかし必要ではない
cMask_AllCharsFixed C いずれかのUtf8文字, しかし空白ではない
cMask_Number 9 ただ1つの数字しかし必要ではない[('0'..'9'])
cMask_NumberFixed 0 ただ1つの数字(任意!)
cMask_NumberPlusMin # ただ1つの数字 [('0'..'9']) '+' または '-'、 しかし必要ではない
cMask_HourSeparator : 自動的に時刻区切り文字を入力する
cMask_DateSeparator / 自動的に日付区切り文字を入力する
cMask_Hex h 1つの16進数しかし必要ではない Lazarus拡張 Delphiではサポートされない
cMask_HexFixed H 1つの16進数 Lazarus拡張 Delphiではサポートされない
cMask_Binary b 1つの2進数しかし必要ではない Lazarus拡張 Delphiではサポートされない
cMask_BinaryFixed B 1つの2進数 Lazarus拡張 Delphiではサポートされない
cMask_SetStart [ セットの始まり(もしEnableSets = Trueなら) Lazarus拡張 Delphiではサポートされない
cMask_SetEnd ] セットの終わり(もしif EnableSets = Trueなら) Lazarus拡張 Delphiではサポートされない
cMask_SetNegate ! セットの否定(セットの内側で始まりに用いられたならば) Lazarus拡張 Delphiではサポートされない
cMask_SetOptional | セットをオプションとする、そのため空を許容する(もしセットの内側で始まりに用いられたならば、セットは否定されない) Lazarus拡張 Delphiではサポートされない
cMask_NoLeadingBlanks ! データの始まりの空白を除く、さもなくば後ろの空白を除く

検証の際の例外を避ける

ユーザーがTMaskEditを離れる(もしくは Enterを押す)時に、コントロールは編集マスク(EditMask)に沿って入力を検証する。
デフォルトは検証が失敗するとEDBEditError例外が発生する。
もし、この例外を捕捉したければ、これをOnException イベントのApplication'sで行わなければならない。
ValidationErrorModeプロパティをmvemEventに設定し、検証エラーをTMaskEditの OnValidationErrorイベントで捕捉すれば、検証の際の例外を避けることができる。
これはTMaskEditのLazarus拡張で、Delphi互換では「ない」ことに注意。

EditMaskのサンプルファイル

TMaskEdit.EditMaskのプロパティエディタはサンプルファイルを入力することをサポートしている。
DelphiサンプルのEditMaskファイル(*.dem)はすでに長い間サポートされており、Lazarus 4.0はLazarusサンプルEditMask(*.lem)が加えられた。
後者はより寛容な文法で、ホワイトスペースは重要ではない(言い換えればそれは無視される)。
著作権の関係からLazarusはサンプルEditMaskそのものを配布しない。

EditMaskファイルの文法

サンプルEditMaskファイルは平文テキストファイルで、それぞれのサンプルEditMaskが1行に定義されている。
それぞれの行はパイプシンボルで3つのフィールドに分けられている。Delphiサンプルファイル(*.dem)はスペースに囲われてなければならない
//で始まる行は無視される。これを自身のサンプルEditMaskファイルのコメントとして加えることができる。
LazarusはファイルはUTF-8でエンコードされているものとみなすことに注意すること。

フィールド名 意味
キャプション プロパティエディタに表示されるサンプルエディットマスクの名前
エディットマスクに対するテキスト例(*)
エディットマスク サンプルエディットマスク

* 凡例テキストをつけるとき、サンプルエディットマスクのMaskSaveとSpaceCharフィールドは無視される(そしてそれぞれFalse、空白文字(#32)に設定される)。これはDelphi互換性のためになされている
以下のサンプルファイルの行を考えてみること:
IPv4 value | 128255255032 | !999.999.999.999;1;_
これは"IPv4 value"をキャプションに、"128.255.255.032"をプロパティエディタのリストボックス例に表示する(クオートは除く)。

以下も参照のこと


LCL Components
Component Tab Components
Standard TMainMenu • TPopupMenu • TButton • TLabel • TEdit • TMemo • TToggleBox • TCheckBox • TRadioButton • TListBox • TComboBox • TScrollBar • TGroupBox • TRadioGroup • TCheckGroup • TPanel • TFrame • TActionList
Additional TBitBtn • TSpeedButton • TStaticText • TImage • TShape • TBevel • TPaintBox • TNotebook • TLabeledEdit • TSplitter • TTrayIcon • TControlBar • TFlowPanel • TMaskEdit • TCheckListBox • TScrollBox • TApplicationProperties • TStringGrid • TDrawGrid • TPairSplitter • TColorBox • TColorListBox • TValueListEditor
Common Controls TTrackBar • TProgressBar • TTreeView • TListView • TStatusBar • TToolBar • TCoolBar • TUpDown • TPageControl • TTabControl • THeaderControl • TImageList • TPopupNotifier • TDateTimePicker
Dialogs TOpenDialog • TSaveDialog • TSelectDirectoryDialog • TColorDialog • TFontDialog • TFindDialog • TReplaceDialog • TTaskDialog • TOpenPictureDialog • TSavePictureDialog • TCalendarDialog • TCalculatorDialog • TPrinterSetupDialog • TPrintDialog • TPageSetupDialog
Data Controls TDBNavigator • TDBText • TDBEdit • TDBMemo • TDBImage • TDBListBox • TDBLookupListBox • TDBComboBox • TDBLookupComboBox • TDBCheckBox • TDBRadioGroup • TDBCalendar • TDBGroupBox • TDBGrid • TDBDateTimePicker
Data Access TDataSource • TCSVDataSet • TSdfDataSet • TBufDataset • TFixedFormatDataSet • TDbf • TMemDataset
System TTimer • TIdleTimer • TLazComponentQueue • THTMLHelpDatabase • THTMLBrowserHelpViewer • TAsyncProcess • TProcessUTF8 • TProcess • TSimpleIPCClient • TSimpleIPCServer • TXMLConfig • TEventLog • TServiceManager • TCHMHelpDatabase • TLHelpConnector
Misc TColorButton • TSpinEdit • TFloatSpinEdit • TArrow • TCalendar • TEditButton • TFileNameEdit • TDirectoryEdit • TDateEdit • TTimeEdit • TCalcEdit • TFileListBox • TFilterComboBox • TComboBoxEx • TCheckComboBox • TButtonPanel • TShellTreeView • TShellListView • TXMLPropStorage • TINIPropStorage • TJSONPropStorage • TIDEDialogLayoutStorage • TMRUManager • TStrHolder
LazControls TCheckBoxThemed • TDividerBevel • TExtendedNotebook • TListFilterEdit • TListViewFilterEdit • TLvlGraphControl • TShortPathEdit • TSpinEditEx • TFloatSpinEditEx • TTreeFilterEdit • TExtendedTabControl •
RTTI TTIEdit • TTIComboBox • TTIButton • TTICheckBox • TTILabel • TTIGroupBox • TTIRadioGroup • TTICheckGroup • TTICheckListBox • TTIListBox • TTIMemo • TTICalendar • TTIImage • TTIFloatSpinEdit • TTISpinEdit • TTITrackBar • TTIProgressBar • TTIMaskEdit • TTIColorButton • TMultiPropertyLink • TTIPropertyGrid • TTIGrid
SQLdb TSQLQuery • TSQLTransaction • TSQLScript • TSQLConnector • TMSSQLConnection • TSybaseConnection • TPQConnection • TPQTEventMonitor • TOracleConnection • TODBCConnection • TMySQL40Connection • TMySQL41Connection • TMySQL50Connection • TMySQL51Connection • TMySQL55Connection • TMySQL56Connection • TMySQL57Connection • TSQLite3Connection • TIBConnection • TFBAdmin • TFBEventMonitor • TSQLDBLibraryLoader
Pascal Script TPSScript • TPSScriptDebugger • TPSDllPlugin • TPSImport_Classes • TPSImport_DateUtils • TPSImport_ComObj • TPSImport_DB • TPSImport_Forms • TPSImport_Controls • TPSImport_StdCtrls • TPSCustomPlugin
SynEdit TSynEdit • TSynCompletion • TSynAutoComplete • TSynMacroRecorder • TSynExporterHTML • TSynPluginSyncroEdit • TSynPasSyn • TSynFreePascalSyn • TSynCppSyn • TSynJavaSyn • TSynPerlSyn • TSynHTMLSyn • TSynXMLSyn • TSynLFMSyn • TSynDiffSyn • TSynUNIXShellScriptSyn • TSynCssSyn • TSynPHPSyn • TSynTeXSyn • TSynSQLSyn • TSynPythonSyn • TSynVBSyn • TSynAnySyn • TSynMultiSyn • TSynBatSyn • TSynIniSyn • TSynPoSyn
Chart TChart • TListChartSource • TRandomChartSource • TUserDefinedChartSource • TCalculatedChartSource • TDbChartSource • TChartToolset • TChartAxisTransformations • TChartStyles • TChartLegendPanel • TChartNavScrollBar • TChartNavPanel • TIntervalChartSource • TDateTimeIntervalChartSource • TChartListBox • TChartExtentLink • TChartImageList
IPro TIpFileDataProvider • TIpHtmlDataProvider • TIpHttpDataProvider • TIpHtmlPanel
Virtual Controls TVirtualDrawTree • TVirtualStringTree • TVTHeaderPopupMenu