Compartilhar via


estrutura HH_WINTYPE (htmlhelp.h)

Use essa estrutura para especificar ou modificar os atributos de um tipo de janela.

Sintaxe

typedef struct tagHH_WINTYPE {
  int         cbStruct;
  BOOL        fUniCodeStrings;
  LPCTSTR     pszType;
  DWORD       fsValidMembers;
  DWORD       fsWinProperties;
  LPCTSTR     pszCaption;
  DWORD       dwStyles;
  DWORD       dwExStyles;
  RECT        rcWindowPos;
  int         nShowState;
  HWND        hwndHelp;
  HWND        hwndCaller;
  HH_INFOTYPE *paInfoTypes;
  HWND        hwndToolBar;
  HWND        hwndNavigation;
  HWND        hwndHTML;
  int         iNavWidth;
  RECT        rcHTML;
  LPCTSTR     pszToc;
  LPCTSTR     pszIndex;
  LPCTSTR     pszFile;
  LPCTSTR     pszHome;
  DWORD       fsToolBarFlags;
  BOOL        fNotExpanded;
  int         curNavType;
  int         tabpos;
  int         idNotify;
  BYTE        tabOrder[HH_MAX_TABS + 1];
  int         cHistory;
  LPCTSTR     pszJump1;
  LPCTSTR     pszJump2;
  LPCTSTR     pszUrlJump1;
  LPCTSTR     pszUrlJump2;
  RECT        rcMinSize;
  int         cbInfoTypes;
  LPCTSTR     pszCustomTabs;
} HH_WINTYPE, *PHH_WINTYPE;

Membros

cbStruct

Especifica o tamanho da estrutura. Esse valor sempre deve ser preenchido antes de passar a estrutura para HtmlHelp().

fUniCodeStrings

Especifica se as cadeias de caracteres usadas nessa estrutura são UNICODE.

pszType

Uma cadeia de caracteres terminada em nulo que especifica o nome do tipo de janela.

fsValidMembers

Especifica quais membros na estrutura são válidos.

fsWinProperties

Especifica as propriedades da janela, como se ela é o Visualizador de Ajuda HTML padrão ou se inclui uma guia Pesquisa.

pszCaption

Uma cadeia de caracteres terminada em nulo que especifica o legenda a ser exibido na barra de título da janela.

dwStyles

Especifica os estilos usados para criar a janela. Esses estilos podem ser ignorados, combinados com estilos estendidos ou usados exclusivamente dependendo do valor dos parâmetros fsValidMembers e fsWinProperties .

dwExStyles

Especifica os estilos estendidos usados para criar a janela. Esses estilos podem ser ignorados, combinados com estilos padrão ou usados exclusivamente dependendo do valor dos parâmetros fsValidMembers e fsWinProperties .

rcWindowPos

Especifica as coordenadas da janela em pixels. Os valores são lidos na seguinte ordem:

rcWindowPos = {left, top, right, bottom};

nShowState

Especifica o estado de exibição inicial da janela. Os valores válidos são os mesmos da função ShowWindow da API do Win32.

hwndHelp

Especifica o identificador da janela se a janela tiver sido criada.

hwndCaller

Especifica a janela que receberá mensagens de notificação da Ajuda HTML. As mensagens de notificação são enviadas por meio de mensagens do Windows WM_NOTIFY .

paInfoTypes

Ponteiro para uma matriz de Tipos de Informações.

hwndToolBar

Especifica o identificador da barra de ferramentas.

hwndNavigation

Especifica o identificador do painel Navegação.

hwndHTML

Especifica o identificador do painel Tópico, que hospeda Shdocvw.dll.

iNavWidth

Especifica a largura do painel navegação quando o Help Viewer é expandido.

rcHTML

Especifica as coordenadas do painel Tópico.

pszToc

Especifica o arquivo de conteúdo (.hhc) a ser exibido no painel Navegação.

pszIndex

Especifica o arquivo de índice (.hhk) a ser exibido no painel Navegação.

pszFile

Especifica o arquivo HTML padrão a ser exibido no painel Tópico.

pszHome

Especifica o arquivo ou URL a ser exibido no painel Tópico quando o botão Página Inicial é clicado.

Especifica quais botões incluir na barra de ferramentas.

fsToolBarFlags

Especifica quais botões incluir no painel barra de ferramentas de um Visualizador de Ajuda de três painéis.

fNotExpanded

Especifica que o Help Viewer é aberto com o painel Navegação fechado.

curNavType

Especifica a guia padrão a ser exibida no painel Navegação.

tabpos

Especifica onde colocar as guias no painel Navegação do Visualizador da Ajuda HTML.

idNotify

Especifica uma ID diferente de zero para habilitar mensagens de notificação da Ajuda HTML. Essa ID é passada como o valor wParam das mensagens do Windows WM_NOTIFY .

tabOrder[HH_MAX_TABS + 1]

Ordem de tabulação: Conteúdo, Índice, Pesquisa, Histórico, Favoritos, Reservado 1-5, Guias personalizadas

cHistory

Número de itens de histórico a serem mantidos. (Padrão: 30)

pszJump1

Especifica o texto a ser exibido abaixo do botão Jump1.

pszJump2

Especifica o texto a ser exibido abaixo do botão Jump2.

pszUrlJump1

Especifica a URL a ser acessada quando o botão Jump1 é clicado.

pszUrlJump2

Especifica a URL a ser acessada quando o botão Jump2 é clicado.

rcMinSize

Tamanho mínimo para a janela (ignorado na versão 1).

cbInfoTypes

Tamanho de paInfoTypes

pszCustomTabs

Série de cadeias de caracteres terminadas em zero a serem usadas como rótulos de guia.

Comentários

Os tipos de janela podem ser definidos por um autor em um arquivo de projeto (.hhp) ou podem ser definidos programaticamente usando a API de Ajuda HTML.

Quando uma estrutura de HH_WINTYPE é passada para HtmlHelp() usando o comando HH_SET_WIN_TYPE , a API de Ajuda HTML faz uma cópia privada do conteúdo da estrutura. Portanto, o desenvolvedor de ajuda é responsável por liberar a memória usada pela estrutura HH_WINTYPE ou matrizes de caracteres dentro dela. O desenvolvedor de ajuda pode liberar memória depois de chamar HH_SET_WIN_TYPE.

Usado por

Requisitos

Requisito Valor
Cabeçalho htmlhelp.h

Confira também

Sobre estruturas