PROPSHEETPAGE

9/9/2008

Essa estrutura define uma página em um folha de propriedades.

Syntax

typedef struct _PROPSHEETPAGE { 
  DWORD dwSize; 
  DWORD dwFlags; 
  HINSTANCE hInstance; 
  union {
    LPCSTR pszTemplate; 
    LPCDLGTEMPLATE pResource; 
  };
  union {
    HICON hIcon; 
    LPCSTR pszIcon; 
  };
  LPCSTR pszTitle; 
  DLGPROC pfnDlgProc; 
  LPARAM lParam; 
  LPFNPSPCALLBACK pfnCallback; 
  UINT FAR* pcRefParent; 
} PROPSHEETPAGE, FAR* LPPROPSHEETPAGE;
typedef const PROPSHEETPAGE FAR* LPCPROPSHEETPAGE;

Os membros

• dwSize
  Especifica o tamanho, em bytes, da estrutura. O tamanho inclui qualquer adicional Application-defined dados no final de estrutura.

• dwFlags
  Especifica um máscara de bits de sinalizadores que opcional habilitar atributos de página de folha de propriedades e indicar o válido membros das PROPSHEETPAGE estrutura. Esse membro pode ser qualquer combinação dos seguinte valores.

  Valor	Descrição
  PSP_DEFAULT	Usa o significado usar como padrão para todos os membros estrutura.
  PSP_DLGINDIRECT	Cria a página de modelo caixa de diálogo na memória apontada pelo pResource membro. O Microsoft Win32® PropertySheet função supõe que o modelo está na memória gravável; Um modelo READ-ONLY irá causar uma exceção em algumas versões do Windows. Se este sinalizador não estiver definida, a página carregará o modelo caixa diálogo do recurso identificado pelo pszTemplate membro.
  PSP_HASHELP	Permite que o botão ' ajuda ' folha de propriedades quando esta página está ativo.
  PSP_USECALLBACK	Chama a função especificada pelo pfnCallback Quando criar ou destruir a página folha de propriedades definido por essa estrutura.
  PSP_HICON	Não suportado.
  PSP_PREMATURE	A página é criada quando o folha de propriedades é criado. Normalmente, a página não é criada até o primeiro tempo que ela estiver marcada.
  PSP_USEICONID	Não suportado.
  PSP__USEREFPARENT	Mantém o contagem de referência especificado por pcRefParent Para a tempo de vida da página folha de propriedades criada a partir essa estrutura.
  PSP_USETITLE	Usa pszTitle Como o título da caixa de diálogo folha de propriedades instead of o título armazenado no modelo caixa de diálogo.
  PSP_RTLREADING	Inverte a direção na qual pszTitle é exibida. Exibir janelas normal todo o texto, incluindo pszTitle, da esquerda - para - direito (EPD). Para os idiomas como árabe, hebraico ou que ler right-to-Left (RTL), uma janela pode ser espelhada e todo o texto será exibido RTL. Se PSP_RTLREADING for definido, pszTitle será, em vez disso, ler RTL em um janela pai normal e EPD em um janela pai espelhado.

• hInstance
  Identificador para a instância a partir da qual carregar o modelo caixa diálogo, o ícone ou recurso seqüência de caracteres de título.

• pszTemplate
  Esse parâmetro é ignorado. DLG_PROPSHEET é o identificador recurso usar como padrão para o modelo caixa diálogo usar para criar a página. Para ajustar o tamanho ou outros atributos de caixa de diálogo pai para o folha de propriedades, você pode editar o correspondente arquivo recurso (. res) para o tamanho desejado. O correspondente arquivo recurso pode ser encontrado em %_WINCEROOT%\PUBLIC\COMMON\OAK\LIB\ <BSPFamily> \RETAIL\ <LangID> \commctrlbase.res.

• pResource
  Ponteiro para um modelo caixa diálogo na memória. O Win32 PropertySheet função supõe que o modelo está na memória gravável; Um modelo READ-ONLY irá causar uma exceção em algumas versões do Windows. Se dwFlags Não inclua o valor PSP_DLGINDIRECT, esse membro será ignorado.

• hIcon
  Ignorado. Deve ser NULL.

• pszIcon
  Ignorado. Deve ser NULL.

• pszTitle
  Ponteiro para o seqüência de caracteres NULL-Terminated que contém o título da caixa de diálogo folha de propriedades. Esse título substitui o título especificado no modelo caixa de diálogo. Esse membro pode especificar ao identificador de um recurso seqüência de caracteres ou o ponteiro para uma seqüência de caracteres que especifica o título. Se dwFlags Não inclua o valor PSP_USETITLE, esse membro será ignorado.

• pfnDlgProc
  Ponteiro para o procedimento caixa de diálogo para a página. O procedimento caixa de diálogo não deve chamar o Win32 EndDialog função.

• lParam
  Application-defined dados.

• pfnCallback
  Ponteiro para uma função callback Application-defined que é chamado quando a página é criada e quando ele está prestes a ser destruídos. Para obter mais informações sobre o função callback Win32, consulte PropSheetPageProc. Se dwFlags Não inclua o valor PSP_USECALLBACK, esse membro será ignorado.

• pcRefParent
  Ponteiro para o valor contagem de referência. Se dwFlags Não inclua o valor PSP_USERREFPARENT, esse membro será ignorado.

Remarks

Quando o PropertySheet função cria a página, o procedimento caixa diálogo para a página recebe um WM_INITDIALOG mensagem. O lParam parâmetro desta mensagem aponta para a estrutura PROPSHEETPAGE usada para criar a página.

Requirements

See Also

Reference

CreatePropertySheetPage
EndDialog
PropertySheet
PropSheetPageProc
WM_INITDIALOG