HH_AKLINK 구조체(htmlhelp.h)

검색하려는 하나 이상의 ALink 이름 또는 KLink 키워드를 지정하려면 이 구조를 사용합니다.

구문

typedef struct tagHH_AKLINK {
  int     cbStruct;
  BOOL    fReserved;
  LPCTSTR pszKeywords;
  LPCTSTR pszUrl;
  LPCTSTR pszMsgText;
  LPCTSTR pszMsgTitle;
  LPCTSTR pszWindow;
  BOOL    fIndexOnFail;
} HH_AKLINK;

멤버

cbStruct

구조체의 크기를 지정합니다. 이 값은 구조를 HTML 도움말 API에 전달하기 전에 항상 채워야 합니다.

fReserved

이 매개 변수는 FALSE로 설정해야 합니다.

pszKeywords

조회할 하나 이상의 ALink 이름 또는 KLink 키워드를 지정합니다. 여러 항목은 세미콜론으로 구분됩니다.

pszUrl

조회가 실패할 경우 탐색할 토픽 파일을 지정합니다. pszURL 은 지정된 컴파일된 도움말(.chm) 파일 내에서 유효한 토픽 을 참조하며 HTML 파일을 가리키는 인터넷 프로토콜을 지원하지 않습니다.

pszMsgText

조회가 실패하고 fIndexOnFail 이 FALSE이고 pszURL 이 NULL인 경우 메시지 상자에 표시할 텍스트를 지정합니다.

pszMsgTitle

pszMsgText 매개 변수가 표시되는 메시지 상자의 캡션 지정합니다.

pszWindow

다음 중 하나를 표시할 창 형식의 이름을 지정합니다.

  • 조회가 하나 이상의 일치하는 topics 생성하는 경우 선택한 항목입니다.
  • 조회가 실패하고 항목이 pszURL에 지정된 경우 pszURL에 지정된 항목입니다.
조회가 실패하고 fIndexOnFail 이 TRUE로 지정된 경우 인덱스 탭입니다.

fIndexOnFail

조회가 실패할 경우 HTML 도움말 뷰어의 인덱스 탭에 키워드(keyword) 표시할지 여부를 지정합니다. pszWindow 값은 도움말 뷰어를 지정합니다.

설명

  • ALink 이름 및 KLink 키워드(keyword) 조회는 대/소문자를 구분하며 여러 키워드는 세미콜론으로 구분됩니다.
  • 조회에서 하나 이상의 일치하는 topics 생성하면 항목 제목이 발견된 항목 대화 상자에 표시됩니다.
조회에서 일치하는 topics 생성하지 않으면 HtmlHelp()는 다음 HH_AKLINK 멤버의 값을 확인하여 수행할 대체 작업을 결정합니다.
  • fIndexOnFail. fIndexOnFail이 TRUE이면 pszWindow에 지정된 도움말 창에서 인덱스 탭이 선택되고 pszKeyword에 지정된 키워드(keyword) 항목 필드에서 선택됩니다.
  • pszURL. fIndexOnFail이 FALSE이면 pszURL에 지정된 토픽 파일이 pszWindow에 지정된 도움말 창에 나타납니다.
  • pszMsgTextpszMsgTitle. fIndexOnFail이 FALSE이고 pszURL이 NULL이면 pszMsgText 및 pszMsgTitle에 지정된 텍스트 및 캡션 사용하여 메시지 상자 나타납니다.

사용 기준

요구 사항

요구 사항
헤더 htmlhelp.h

추가 정보

구조체 정보