Compartilhar via

estrutura PROPSHEETUI_INFO_HEADER (compstui.h)

  • Artigo

A estrutura PROPSHEETUI_INFO_HEADER é usada como um parâmetro de entrada para a função do tipo PFNPROPSHEETUI de um aplicativo, quando a função é chamada com um valor de motivo de PROPSHEETUI_REASON_GET_INFO_HEADER.

Sintaxe

typedef struct _PROPSHEETUI_INFO_HEADER {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  HWND      hWndParent;
  HINSTANCE hInst;
  union {
    HICON     hIcon;
    ULONG_PTR IconID;
  } DUMMYUNIONNAME;
} PROPSHEETUI_INFO_HEADER, *PPROPSHEETUI_INFO_HEADER;

Membros

cbSize

Tamanho fornecido por CPSUI, em bytes, da estrutura PROPSHEETUI_INFO_HEADER .

Flags

Sinalizadores de bits opcionais especificados pelo aplicativo que modificam a aparência da página da folha de propriedades. Os sinalizadores listados na tabela a seguir podem ser usados em qualquer combinação.

Sinalizador Descrição
PSUIHDRF_DEFTITLE Se definido, CPSUI deverá incluir "Padrão" na cadeia de caracteres da barra de título. CPSUI adiciona "Default" após a cadeia de caracteres pTitle e, se PSUIHDRF_PROPTITLE estiver definida, antes de "Propriedades".
PSUIHDRF_EXACT_PTITLE Se definido, CPSUI usará o texto especificado por pTitle sem modificação. Esse sinalizador substitui PSUIHDRF_DEFTITLE e PSUIHDRF_PROPTITLE.
PSUIHDRF_NOAPPLYNOW Se definido, o CPSUI não deverá incluir um botão Aplicar Agora .
PSUIHDRF_PROPTITLE Se definido, CPSUI deverá acrescentar "Propriedades" à cadeia de caracteres da barra de título. (Por padrão, o CPSUI define esse sinalizador antes de chamar o aplicativo.)
PSUIHDRF_USEHICON Se definido, a união hIcon/IconID contém um identificador de ícone. Se não for definido, a união conterá um identificador de recurso de ícone.

pTitle

Identificador de cadeia de caracteres, representando o texto a ser exibido na barra de título da folha de propriedades. Pode ser um ponteiro de 32 bits para uma cadeia de caracteres terminada em NULL ou pode ser um identificador de recurso de cadeia de caracteres de 16 bits com HIWORD definido como zero. Para DLLs de interface da impressora, a cadeia de caracteres normalmente contém o nome da impressora.

hWndParent

Manipule para a janela a ser usada como o pai da folha de propriedades. Por padrão, o CPSUI fornece o identificador de janela que recebeu para o parâmetro hWndOwner para CommonPropertySheetUI, mas o aplicativo pode substituir esse identificador por outro.

hInst

Identificador de instância fornecido pelo aplicativo, que o CPSUI usa ao carregar recursos do aplicativo.

DUMMYUNIONNAME

Essa união identifica o ícone a ser exibido na barra de título da folha de propriedades.

DUMMYUNIONNAME.hIcon

Define o hIcon do membro HICON.

DUMMYUNIONNAME.IconID

Define o ULONG_PTR membro IconID. O membro do sindicato é selecionado por PSUIHDRF_USEICON em Sinalizadores.

Requisitos

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