Estrutura COMPROPSHEETUI (compstui.h)

Artigo
02/06/2025

A estrutura COMPROPSHEETUI é usada como um parâmetro de entrada para a função comPropSheet do CPSUI, se o código de função for CPSFUNC_ADD_PCOMPROPSHEETUI. Todos os membros da estrutura devem ser fornecidos pelo chamador do comPropSheet.

Sintaxe

typedef struct _COMPROPSHEETUI {
  WORD           cbSize;
  WORD           Flags;
  HINSTANCE      hInstCaller;
  LPTSTR         pCallerName;
  ULONG_PTR      UserData;
  LPTSTR         pHelpFile;
  _CPSUICALLBACK pfnCallBack;
  POPTITEM       pOptItem;
  PDLGPAGE       pDlgPage;
  WORD           cOptItem;
  WORD           cDlgPage;
  ULONG_PTR      IconID;
  LPTSTR         pOptItemName;
  WORD           CallerVersion;
  WORD           OptItemVersion;
  ULONG_PTR      dwReserved[4];
} COMPROPSHEETUI, *PCOMPROPSHEETUI;

Membros

cbSize

Tamanho fornecido pelo chamador, em bytes, da estrutura de COMPROPSHEETUI.

Flags

Sinalizadores de bits fornecidos pelo chamador opcional, conforme descrito na seguinte lista:

CPSUIF_ABOUT_CALLBACK

Se definido, a função de retorno de chamada da página (apontada pelo membro pfnCallback membro) da estrutura, dá suporte a CPSUICB_REASON_ABOUT, portanto, o CPSUI chamará a função de retorno de chamada se o usuário clicar no botão Sobre da página. (O CPSUI fornece um botão Sobre para cada nó raiz de visão de árvore.)

CPSUIF_ICONID_AS_HICON

Se definido, o membro IconID da estrutura contém um identificador de ícone.

Se não estiver definido, o membro IconID contém um identificador de recurso de ícone.

CPSUIF_UPDATE_PERMISSION

Se definido, os valores de opção da página poderão ser modificados pelo usuário.

hInstCaller

Identificador de instância de módulo fornecido pelo chamador, recebido pela função de ponto de entrada da DLL.

pCallerName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de texto terminada por NULL que representa o nome do aplicativo. (Para uma DLL de interface de impressora, esse deve ser o nome do driver, como "Driver PostScript".)

UserData

Valor opcional fornecido pelo chamador, que o CPSUI coloca em um membro userData da estrutura CPSUICBPARAM ao chamar a função apontada por pfnCallBack.

pHelpFile

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de texto terminada por NULL que representa um caminho para um arquivo de ajuda. Para DLLs de interface da impressora, esse normalmente é o caminho do arquivo de ajuda obtido chamando GetPrinterDriver.

O arquivo de ajuda é indexado por valores contidos no helpIndex membro de estruturas de OPTITEM.

pfnCallBack

Ponteiro fornecido pelo chamador para uma função de retorno de chamada tipo _CPSUICALLBACK, que o CPSUI chama quando um usuário modifica os valores de opção da página.

Só poderá ser usado se pDlgPage identificar uma estrutura de DLGPAGE fornecida pelo CPSUI ou se o DlgProc membro de uma estrutura DLGPAGE fornecida pelo aplicativo estiver NULL.

pOptItem

Ponteiro fornecido pelo chamador para uma matriz de estruturas OPTITEM que descrevem as opções da página.

pDlgPage

Este membro especifica estruturas de DLGPAGE que descrevem páginas a serem adicionadas à folha de propriedades. Pode ser um dos seguintes:

Um ponteiro para uma matriz de estruturas DLGPAGE.
Um dos ponteiros descritos na lista a seguir. Esses ponteiros fazem referência a estruturas DLGPAGE predefinidas, fornecidas pelo CPSUI para uso por DLLs de interface da impressora.
- CPSUI_PDLGPAGE_ADVDOCPROP
  
  Define uma página de visão de árvore cuja guia lê Advanced. Para uso apenas por uma função drvDocumentPropertySheets.
- CPSUI_PDLGPAGE_DOCPROP
  
  Define três páginas, cujas guias são Layout, Papel/de Qualidade e Avançado. A página Advanced é uma visão de árvore. Para uso apenas por uma função drvDocumentPropertySheets.
- CPSUI_PDLGPAGE_PRINTERPROP
  
  Define uma página de visão de árvore cuja guia lê configurações do dispositivo. Para uso apenas por uma função DrvDevicePropertySheets.
- CPSUI_PDLGPAGE_TREEVIEWONLY
  
  Define uma página de visão de árvore.

cOptItem

Número fornecido pelo chamador de estruturas de OPTITEM apontadas por pOptItem.

cDlgPage

Número fornecido pelo chamador de estruturas de DLGPAGE apontadas por pDlgPage. Não usado se pDlgPage especificar uma estrutura predefinida predefinida com prefixo CPSUI_PDLGPAGE.

IconID

Fornecido pelo chamador, pode ser um dos seguintes:

Um identificador de recurso de ícone. Isso pode ser definido pelo aplicativo ou pode ser um dos identificadores de recurso de ícone fornecidos por CPSUI, com prefixo IDI_CPSUI.
Um identificador de ícone. Se um identificador for especificado, CPSUIF_ICONID_AS_HICON deverá ser definido no membro sinalizadores do.

O ícone especificado é exibido no nó raiz da visão de árvore da página da folha de propriedades.

pOptItemName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres terminada por NULL a ser exibida no nó raiz da visão de árvore da página da folha de propriedades. Para DLLs de interface da impressora, essa cadeia de caracteres normalmente representa um tipo de dispositivo de impressora, como "HP 4si".

CallerVersion

Número de versão fornecido pelo chamador, representando a versão atual do aplicativo de chamada. O byte alto identifica a versão principal e o byte baixo é a versão secundária. Por exemplo, um CallerVersion valor de 0x310 especifica um número de versão de chamador de 3.16. O número da versão é exibido quando um usuário clica no botão Sobre de uma página.

OptItemVersion

Número de versão fornecido pelo chamador, representando a versão atual do item de opção no nível raiz. Para DLLs de interface da impressora, isso normalmente representa uma versão do dispositivo de impressora. O byte alto identifica a versão principal e o byte baixo é a versão secundária. Por exemplo, um valor OptItemVersion de 0x3ff especifica um número de versão de chamador de 3.255. O número da versão é exibido quando um usuário clica no botão Sobre de uma página.

dwReserved[4]

Reservado. Essa matriz deve ser definida como zero.

Requisitos

Requisito	Valor
cabeçalho	compstui.h (inclua Compstui.h)

Compartilhar via