estrutura INSERTPSUIPAGE_INFO (compstui.h)

Artigo
03/08/2023

A estrutura INSERTPSUIPAGE_INFO será usada como um parâmetro de entrada para a função ComPropSheet do CPSUI, se o código de função for CPSFUNC_INSERT_PSUIPAGE. Todos os valores de membro devem ser fornecidos pelo chamador comPropSheet .

Sintaxe

typedef struct _INSERTPSUIPAGE_INFO {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Mode;
  ULONG_PTR dwData1;
  ULONG_PTR dwData2;
  ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;

Membros

cbSize

Tamanho fornecido pelo chamador, em bytes, da estrutura INSERTPSUIPAGE_INFO.

Type

Valor inteiro fornecido pelo chamador que indica o tipo de inserção que está sendo solicitado. O membro pode conter uma das seguintes constantes:

PSUIPAGEINSERT_DLL

CPSUI chama a função tipada PFNPROPSHEETUI especificada, com um valor de motivo de PROPSHEETUI_REASON_INIT. A função está contida em uma DLL separada.

PSUIPAGEINSERT_GROUP_PARENT

O CPSUI cria um novo pai de grupo.

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI insere uma página que foi criada chamando CreatePropertySheetPage.

(Isso equivale a chamar ComPropSheet com um código de função de CPSFUNC_ADD_HPROPSHEETPAGE.)

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI insere páginas descritas por uma estrutura COMPROPSHEETUI .

(Isso é equivalente a chamar ComPropSheet com um código de função de CPSFUNC_ADD_PCOMPROPSHEETUI.)

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI chama a função tipada PFNPROPSHEETUI especificada, com um valor de motivo de PROPSHEETUI_REASON_INIT.

(Isso é equivalente a chamar ComPropSheet com um código de função de CPSFUNC_ADD_PFNPROPSHEETUI.)

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI insere a página descrita pela estrutura PROPSHEETPAGE especificada.

(Isso é equivalente a chamar ComPropSheet com um código de função de CPSFUNC_ADD_PROPSHEETPAGE.)

Mode

Valor fornecido pelo chamador que indica onde o CPSUI deve inserir as novas páginas. Deve ser um dos seguintes valores:

INSPSUIPAGE_MODE_AFTER

CPSUI insere páginas após a página identificada pelo identificador de página CPSUI especificado pelo parâmetro lParam1 para ComPropSheet.

INSPSUIPAGE_MODE_BEFORE

CPSUI insere páginas antes da página identificada pelo identificador de página CPSUI especificado pelo parâmetro lParam1 para ComPropSheet.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI insere páginas como os primeiros filhos do grupo pai identificados pelo parâmetro hComPropSheet para ComPropSheet.

O parâmetro lParam1 para ComPropSheet é ignorado.

INSPUIPAGE_MODE_INDEX

CPSUI insere páginas como filhos do grupo pai identificado pelo parâmetro hComPropSheet para ComPropSheet.

O parâmetro lParam1 para ComPropSheet especifica um índice baseado em zero que identifica onde, dentro do conjunto de filhos, as páginas especificadas devem ser inseridas. Se lParam1 for 0, as páginas serão inseridas a partir da página 1; se lParam1 for 1 , as páginas serão inseridas a partir da página 2; e assim por diante. Se o índice for maior que o número de filhos existentes, as novas páginas serão adicionadas como os últimos filhos. O valor lParam1 deve ser especificado como HINSPSUIPAGE_INDEX(index).

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI insere páginas como os últimos filhos do grupo pai identificados pelo parâmetro hComPropSheet para ComPropSheet.

O parâmetro lParam1 para ComPropSheet é ignorado.

dwData1

Consulte a seção Comentários abaixo.

dwData2

Consulte a seção Comentários abaixo.

dwData3

Consulte a seção Comentários abaixo.

Comentários

Os membros dwData1, dwData2 e dwData3 contêm valores fornecidos pelo chamador que dependem do conteúdo do membro Type , da seguinte maneira:

O membro type contém PSUIPAGEINSERT_DLL

dwData1 – ponteiro fornecido pelo chamador para uma cadeia de caracteres terminada em NULL que representa o nome do caminho da DLL.

dwData2 - Ponteiro fornecido pelo chamador para uma cadeia de caracteres terminada em NULL que representa o nome de uma função tipada PFNPROPSHEETUI , contida na DLL especificada.

dwData3 - Valor de 32 bits fornecido pelo chamador, passado para a função do tipo PFNPROPSHEETUI para seu parâmetro lParam .