Share via


IAgentCharacterEx::GetHelpModeOn

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

HRESULT GetHelpModeOn(
   long * pbHelpModeOn  // address of help mode setting
);

문자에 대해 상황에 맞는 도움말 모드가 설정되었는지 여부를 검색합니다.

  • 작업이 성공했음을 나타내는 S_OK 반환합니다.

pbHelpModeOn

도움말 모드가 문자에 대해 설정되면 True 를 수신하고 그렇지 않으면 False 를 수신하는 변수의 주소입니다.

이 속성을 True로 설정하면 마우스 포인터가 문자 위로 이동하거나 문자의 팝업 메뉴 위로 이동할 때 상황에 맞는 도움말 이미지로 변경됩니다. 사용자가 문자를 클릭하거나 끌거나 문자의 팝업 메뉴에서 항목을 클릭하면 서버는 IAgentNotifySinkEx::HelpComplete 이벤트를 트리거하고 도움말 모드를 종료합니다.

도움말 모드에서는 GetAutoPopupMenu 속성이 True를 반환하지 않는 한 서버에서 IAgentNotifySink::Click, IAgentNotifySink::D ragStart, IAgentNotifySink::D ragCompleteIAgentNotifySink::Command 이벤트를 보내지 않습니다. 이 경우 서버는 IAgentNotifySink::Click 이벤트(도움말 모드를 종료하지 않음)를 보내지만 오른쪽 마우스 단추에 대해서만 팝업 메뉴를 표시할 수 있습니다.

이 속성은 클라이언트 애플리케이션의 문자 사용에만 적용됩니다. 설정은 클라이언트 애플리케이션의 문자 또는 다른 문자의 다른 클라이언트에 영향을 주지 않습니다.

참고 항목

IAgentCharacterEx::SetHelpModeOn