Share via

IAgentCharacterEx::SetHelpContextID

  • 아티클

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

HRESULT SetHelpContextID(
   long ulHelpID  // ID for help topic
);

문자의 HelpContextID 를 설정합니다.

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

ulHelpID

문자와 연결된 도움말 항목의 컨텍스트 번호입니다. 문자에 대한 상황에 맞는 도움말을 제공하는 데 사용됩니다.

애플리케이션에 대한 Windows 도움말 파일을 만들고 이 파일을 문자의 HelpFile 속성에서 설정한 경우 HelpModeOn 이 True 로 설정되고 사용자가 문자를 선택하면 Microsoft 에이전트에서 자동으로 도움말을 호출합니다. HelpContextID에 컨텍스트 번호가 있는 경우 에이전트는 도움말을 호출하고 현재 컨텍스트 번호로 식별된 토픽을 검색합니다. 현재 컨텍스트 번호는 문자의 HelpContextID 값입니다. HelpContextID 속성에 컨텍스트 번호가 있는 경우 도움말은 현재 도움말 컨텍스트에 해당하는 토픽을 표시합니다. 그렇지 않으면 "이 항목과 연결된 도움말 항목 없음"이 표시됩니다.

이 설정은 클라이언트 애플리케이션이 최상위 문자의 활성 클라이언트인 경우에만 적용됩니다. 클라이언트 애플리케이션에서 사용하는 문자 또는 다른 문자의 다른 클라이언트에는 영향을 주지 않습니다.

참고

도움말 파일을 빌드하려면 Microsoft Windows 도움말 컴파일러가 필요합니다.

 

참고 항목

IAgentCharacterEx::GetHelpContextID, IAgentCharacterEx::SetHelpModeOn, IAgentCharacterEx::SetHelpFileName