IAgentCharacter：：GetVisibilityCause

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

HRESULT GetVisibilityCause(
   long * pdwCause  // address of variable for cause of character visible state
);

擷取字元可見狀態的原因。

• 傳回S_OK，表示作業成功。

pdwCause

接收字元上次可見度狀態變更原因的變數位址，而且會是下列其中一項：

值	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	使用者以字元的工作列圖示快顯功能表或使用語音輸入隱藏字元。

另請參閱

IAgentNotifySink：：VisibleState