Condividi tramite


struttura HH_AKLINK (htmlhelp.h)

Utilizzare questa struttura per specificare uno o più nomi ALink o parole chiave KLink da cercare.

Sintassi

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

Members

cbStruct

Specifica le dimensioni della struttura. Questo valore deve sempre essere compilato prima di passare la struttura all'API della Guida HTML.

fReserved

Questo parametro deve essere impostato su FALSE.

pszKeywords

Specifica uno o più nomi ALink o parole chiave KLink da cercare. Più voci sono delimitate da un punto e virgola.

pszUrl

Specifica il file dell'argomento a cui passare se la ricerca ha esito negativo. pszURL fa riferimento a un argomento valido all'interno del file della Guida compilata specificata (con estensione chm) e non supporta i protocolli Internet che puntano a un file HTML.

pszMsgText

Specifica il testo da visualizzare in una finestra di messaggio se la ricerca ha esito negativo e fIndexOnFail è FALSE e pszURL è NULL.

pszMsgTitle

Specifica la didascalia della finestra di messaggio in cui viene visualizzato il parametro pszMsgText.

pszWindow

Specifica il nome del tipo di finestra in cui visualizzare uno dei seguenti elementi:

  • L'argomento selezionato, se la ricerca restituisce uno o più argomenti corrispondenti.
  • L'argomento specificato in pszURL, se la ricerca ha esito negativo e viene specificato un argomento in pszURL.
La scheda Indice, se la ricerca ha esito negativo e fIndexOnFail viene specificata come TRUE.

fIndexOnFail

Specifica se visualizzare la parola chiave nella scheda Indice del Visualizzatore della Guida HTML se la ricerca ha esito negativo. Il valore di pszWindow specifica il Visualizzatore della Guida.

Commenti

  • Le ricerche con parole chiave KLink e nome ALink fanno distinzione tra maiuscole e minuscole e più parole chiave sono delimitate da un punto e virgola.
  • Se la ricerca restituisce uno o più argomenti corrispondenti, i titoli degli argomenti vengono visualizzati nella finestra di dialogo Argomenti trovati.
Se la ricerca non restituisce argomenti corrispondenti, HtmlHelp() controlla i valori dei membri HH_AKLINK seguenti per determinare quale azione alternativa eseguire:
  • fIndexOnFail. Se fIndexOnFail è TRUE, la scheda Indice viene selezionata nella finestra della Guida specificata in pszWindow e la parola chiave specificata in pszKeyword viene selezionata nel campo di immissione.
  • pszURL. Se fIndexOnFail è FALSE, il file dell'argomento specificato in pszURL viene visualizzato nella finestra della Guida specificata in pszWindow.
  • pszMsgText e pszMsgTitle. Se fIndexOnFail è FALSE e pszURL è NULL, viene visualizzata una finestra di messaggio che usa il testo e didascalia specificato in pszMsgText e pszMsgTitle.

Usato da

Requisiti

Requisito Valore
Intestazione htmlhelp.h

Vedi anche

Informazioni sulle strutture