跳轉到主要內容
這個方法是在用戶端實作。當 Document Viewer 被鎖定或解除鎖定後,就會呼叫此方法。Document Viewer 可在長時間處理作業開始前自動鎖定,並在作業結束後解除鎖定。也可以透過 IDocumentViewer::Locked 屬性鎖定或解除鎖定此元件。 此方法會向用戶端提供元件目前是處於鎖定還是解除鎖定狀態的資訊。

語法

C++

HRESULT OnLocked( VARIANT_BOOL Value );

C#

void OnLocked( bool Value );

Visual Basic .NET

Sub OnLocked(Value As Boolean)

參數

[in] 指定元件為鎖定或解除鎖定狀態。如果參數為 TRUE,則元件已鎖定。如果參數為 FALSE,則元件已解除鎖定。

傳回值

[僅限 C++] 如果此方法傳回的值不是 S_OK,表示用戶端發生錯誤。

備註

此方法的用戶端實作必須確保:在方法內部擲出的所有例外狀況都會被攔截並處理,且不會傳播到方法外部。若例外狀況傳播到方法外部,可能會導致無法預期的結果 (例如程式終止) 。

另請參閱

IDocumentViewerEvents