IAgentNotifySink：：VisibleState

[Microsoft 代理程式在 Windows 7 中已被取代，且在後續版本的 Windows 中可能無法使用。]

HRESULT VisibleState(
   long dwCharID,  // character ID
   long bVisible,  // visibility flag
   long dwCause,   // cause of visible state
);                          

當字元的可見度狀態變更時，通知用戶端應用程式。

• 沒有傳回值。

dwCharID

變更可見度狀態的字元識別碼。

bVisible

可見度旗標。 當字元變成可見時，這個布林值為 True ，當字元變成隱藏時為 False 。

dwCause

上次變更字元可見度狀態的原因。 參數可能是下列其中一項：

值	Description
const unsigned shortNeverShown = 0;	尚未顯示字元。
const unsigned shortUserHid = 1;	使用者以字元的工作列圖示快顯視窗或語音輸入隱藏字元。
const unsigned shortUserShowed = 2;	使用者顯示字元。
const unsigned shortProgramHid = 3;	您的應用程式會隱藏字元。
const unsigned shortProgramShowed = 4;	您的應用程式顯示字元。
const unsigned shortOtherProgramHid = 5;	另一個應用程式會隱藏字元。
const unsigned shortOtherProgramShowed = 6;	另一個應用程式顯示字元。
const unsigned shortUserHidViaCharacterMenu = 7	使用者以字元的快顯功能表隱藏字元。
const unsigned shortUserHidViaTaskbarIcon = UserHid	使用者以字元的工作列圖示快顯功能表或使用語音輸入隱藏字元。

另請參閱

IAgentCharacter：：GetVisible、 IAgentCharacter：：GetVisibilityCause