MaskedTextProvider.InsertAt メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
書式設定された文字列内の特定の位置に文字または文字列を挿入します。
オーバーロード
InsertAt(Char, Int32) |
書式設定された文字列内の指定した位置に指定した文字を挿入します。 |
InsertAt(String, Int32) |
書式設定された文字列内の指定した位置に指定した文字列を挿入します。 |
InsertAt(Char, Int32, Int32, MaskedTextResultHint) |
書式設定された文字列内の指定した位置に指定した文字を挿入し、最後の挿入位置と操作のステータスを返します。 |
InsertAt(String, Int32, Int32, MaskedTextResultHint) |
書式設定された文字列内の指定した位置に指定した文字列を挿入し、最後の挿入位置と操作のステータスを返します。 |
InsertAt(Char, Int32)
書式設定された文字列内の指定した位置に指定した文字を挿入します。
public:
bool InsertAt(char input, int position);
public bool InsertAt (char input, int position);
member this.InsertAt : char * int -> bool
Public Function InsertAt (input As Char, position As Integer) As Boolean
パラメーター
- position
- Int32
文字を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。
戻り値
挿入が正常に実行された場合は true
。それ以外の場合は false
。
注釈
メソッドは InsertAt 、 パラメーターで指定された位置以降の最初の編集位置に文字を pos
挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を 1 つの位置にシフトして、挿入 input
された文字のスペースを作ります。 次のいずれかのエラーが発生した場合、挿入は実行されず、 メソッドは を返します false
。
パラメーターが
pos
0 より小さいか、書式設定された文字列の より Length 大きい。編集可能な文字が、指定した位置
pos
() 以降の書式設定された文字列に見つかりませんでした。挿入文字 である は、印刷できないか、
input
対応するマスク要素と一致しないため、有効な入力文字ではありません。カーソルの右側に使用可能な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスク違反が発生します。
空 input
の文字列では、書式設定された文字列は変更されませんが、 が返 true
されます。
こちらもご覧ください
適用対象
InsertAt(String, Int32)
書式設定された文字列内の指定した位置に指定した文字列を挿入します。
public:
bool InsertAt(System::String ^ input, int position);
public bool InsertAt (string input, int position);
member this.InsertAt : string * int -> bool
Public Function InsertAt (input As String, position As Integer) As Boolean
パラメーター
- position
- Int32
入力文字列を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。
戻り値
挿入が正常に実行された場合は true
。それ以外の場合は false
。
例外
input
パラメーターが null
です。
注釈
メソッドは InsertAt 、文字列から位置以降の input
編集位置に各文字を pos
挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を、挿入された文字ごとに 1 つの位置にシフトします。 次のいずれかのエラーが発生した場合、挿入は実行されません。メソッドは を返します false
。
パラメーターが
pos
0 より小さいか、書式設定された文字列の より Length 大きい。文字列からすべての文字を挿入するために、
pos
書式設定された文字列内に、指定した位置を超える十分な編集可能な文字がinput
存在しません。1 つ以上の挿入文字は、印刷できないか、対応するマスク要素と一致しないため、有効な入力文字ではありません。
挿入ポイントの右側に十分な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスク違反が発生します。 このシフトは、個々の文字の挿入中に発生することに注意してください。
空 input
の文字列では、書式設定された文字列は変更されませんが、 が返 true
されます。
こちらもご覧ください
適用対象
InsertAt(Char, Int32, Int32, MaskedTextResultHint)
書式設定された文字列内の指定した位置に指定した文字を挿入し、最後の挿入位置と操作のステータスを返します。
public:
bool InsertAt(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool InsertAt (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.InsertAt : char * int * int * MaskedTextResultHint -> bool
Public Function InsertAt (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean
パラメーター
- position
- Int32
文字を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。
- testPosition
- Int32
メソッドが正常に実行された場合は、文字が挿入された最後の位置。それ以外の場合は、挿入が失敗した最初の位置。 出力パラメーター。
- resultHint
- MaskedTextResultHint
挿入操作の結果を簡潔に示す MaskedTextResultHint。 出力パラメーター。
戻り値
挿入が正常に実行された場合は true
。それ以外の場合は false
。
注釈
メソッドは InsertAt 、 パラメーターで指定された位置以降の最初の編集位置に文字を pos
挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を 1 つの位置にシフトして、挿入 input
された文字のスペースを作ります。 次のいずれかのエラーが発生した場合、挿入は実行されず、 メソッドは を返します false
。
パラメーターが
pos
0 より小さいか、書式設定された文字列の より Length 大きい。編集可能な文字が、指定した位置
pos
() 以降の書式設定された文字列に見つかりませんでした。挿入文字 である は、印刷できないか、
input
対応するマスク要素と一致しないため、有効な入力文字ではありません。カーソルの右側に使用可能な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスク違反が発生します。
空 input
の文字列では、書式設定された文字列は変更されませんが、 が返 true
されます。
こちらもご覧ください
適用対象
InsertAt(String, Int32, Int32, MaskedTextResultHint)
書式設定された文字列内の指定した位置に指定した文字列を挿入し、最後の挿入位置と操作のステータスを返します。
public:
bool InsertAt(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool InsertAt (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.InsertAt : string * int * int * MaskedTextResultHint -> bool
Public Function InsertAt (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean
パラメーター
- position
- Int32
入力文字列を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。
- testPosition
- Int32
メソッドが正常に実行された場合は、文字が挿入された最後の位置。それ以外の場合は、挿入が失敗した最初の位置。 出力パラメーター。
- resultHint
- MaskedTextResultHint
挿入操作の結果を簡潔に示す MaskedTextResultHint。 出力パラメーター。
戻り値
挿入が正常に実行された場合は true
。それ以外の場合は false
。
例外
input
パラメーターが null
です。
注釈
メソッドは InsertAt 、文字列から位置以降の input
編集位置に各文字を pos
挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を、挿入された文字ごとに 1 つの位置にシフトします。 次のいずれかのエラーが発生した場合、挿入は実行されません。メソッドは を返します false
。
パラメーターが
pos
0 より小さいか、書式設定された文字列の より Length 大きい。文字列からすべての文字を挿入するために、
pos
書式設定された文字列内に、指定した位置を超える十分な編集可能な文字がinput
存在しません。1 つ以上の挿入文字は、印刷できないか、対応するマスク要素と一致しないため、有効な入力文字ではありません。
挿入ポイントの右側に十分な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスク違反が発生します。 このシフトは、個々の文字の挿入中に発生することに注意してください。
空 input
の文字列では、書式設定された文字列は変更されませんが、 が返 true
されます。
こちらもご覧ください
適用対象
.NET