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 パラメーターで指定された位置以降の最初の編集位置に文字を挿入します。 このメソッドは、挿入された input 文字のスペースを作成するために、挿入ポイントの後にあるすべての既存の文字を 1 つの位置にシフトします。 次のいずれかのエラーが発生した場合、挿入は実行されず、メソッドは falseを返します。
posパラメーターが 0 未満であるか、書式設定された文字列のLengthより大きい。編集可能な文字が、指定した位置(
pos)以降の書式設定された文字列に見つかりませんでした。挿入文字
inputは、印刷できないか、対応する mask 要素と一致しないため、有効な入力文字ではありません。カーソルの右側に使用可能な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスクの違反が発生します。
空の 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 つ以上の挿入文字は、印刷できないか、対応する mask 要素と一致しないため、有効な入力文字ではありません。
カーソルの右側に十分な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスクの違反が発生します。 このシフトは、個々の文字の挿入中に発生することに注意してください。
空の 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 パラメーターで指定された位置以降の最初の編集位置に文字を挿入します。 このメソッドは、挿入された input 文字のスペースを作成するために、挿入ポイントの後にあるすべての既存の文字を 1 つの位置にシフトします。 次のいずれかのエラーが発生した場合、挿入は実行されず、メソッドは falseを返します。
posパラメーターが 0 未満であるか、書式設定された文字列のLengthより大きい。編集可能な文字が、指定した位置(
pos)以降の書式設定された文字列に見つかりませんでした。挿入文字
inputは、印刷できないか、対応する mask 要素と一致しないため、有効な入力文字ではありません。カーソルの右側に使用可能な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスクの違反が発生します。
空の 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 つ以上の挿入文字は、印刷できないか、対応する mask 要素と一致しないため、有効な入力文字ではありません。
カーソルの右側に十分な位置がないため、既存の文字をシフトできません。
既存の文字をシフトすると、マスクの違反が発生します。 このシフトは、個々の文字の挿入中に発生することに注意してください。
空の input 文字列では、書式設定された文字列は変更されませんが、 trueが返されます。