ITextValidatorEvents インターフェイスの OnLocked メソッド

このメソッドはクライアント側で実装されます。Text Validator がロックまたはロック解除された後に呼び出されます。Text Validator は、長時間の処理が開始される前に自動的にロックされ、その処理の終了後にロック解除されることがあります。また、このコンポーネントは ITextValidator::Locked プロパティによってロックまたはロック解除することもできます。

このメソッドは、コンポーネントがロックされているかロック解除されているかに関する情報をクライアントに渡します。

​

構文

​

C++

HRESULT OnLocked( VARIANT_BOOL Value );

​

C#

void OnLocked( bool Value );

​

Visual Basic .NET

Sub OnLocked(Value As Boolean)

​

Parameters

Value

[in] コンポーネントがロックされるかロック解除されるかを指定します。パラメーターが TRUE の場合、コンポーネントはロックされます。パラメーターが FALSE の場合、コンポーネントはロック解除されます。

​

戻り値

[C++ のみ] このメソッドが S_OK 以外の値を返した場合は、クライアント側でエラーが発生したことを示します。

​

注記

このメソッドのクライアント実装では、メソッド内でスローされるすべての例外を確実にキャッチして処理し、例外がメソッドの外部に伝播しないようにする必要があります。例外がメソッドの外部に伝播すると、予期しない結果 (プログラムの終了など) を招くおそれがあります。

​

関連項目

ITextValidatorEvents