Creating a Property Sheet
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
A folha de propriedades é uma caixa diálogo System-defined que você usar para exibição ou modificar atributos objeto ou propriedades. Inclui um folha de propriedades um quadro, um barra de título e três botões — OK, Cancelar (X), e Ajuda (?) — que estão localizados atop a janela. Para usar folhas propriedade, você deve incluir o arquivo de cabeçalho Prsht.h no seu aplicativo.
Um folha de propriedades contém e gerencia um ou mais relacionado diálogo caixas que são conhecidas como páginas propriedade. Cada página em um folha de propriedades é uma sem janela restrita Application-defined caixa diálogo que gerencia os controles que habilitar um usuário para exibição e editar as propriedades de um objeto. Um folha de propriedades deve conter página de propriedades at least um, mas o folha de propriedades não pode conter mais do que o valor de MAXPROPPAGES, conforme definido no arquivos de cabeçalho.
O usuário acessa propriedade planilhas usando uma ação ALT+Tap. Um folha de propriedades envia uma mensagem para o procedimento caixa de diálogo para uma página quando a página se tornará ativo ou inativo e quando um usuário toques de OK, o Cancelar (X), ou a Ajuda (?) botão. Cada notificação é enviada na forma de uma mensagem WM_NOTIFY. O lParam parâmetro de WM_NOTIFY aponta para um NMHDR estrutura, que inclui o manipulador de janela para a caixa diálogo folha de propriedades. Algumas mensagens exigem que uma página folha de propriedades retornar qualquer TRUE ou FALSE em resposta a WM_NOTIFY. Para responder, a página deve usar o SetWindowLong função para definir o valor para a caixa diálogo página DWL_MSGRESULT o TRUE ou FALSE.
Cada página possui um correspondente rotular, que exibe o folha de propriedades na guia que ele cria para a página. Como todas as páginas em um folha de propriedades espera que você use uma fonte Roman e não negrito, você deve assegurar-se de que a fonte não seja negrito, especificando o estilo DS_3DLOOK no modelo para caixa de diálogo. A seguinte ilustração mostra um folha de propriedades Windows Embedded CE.
.gif)
Antes de criar um folha de propriedades, você deve definir uma ou mais páginas.
Para definir uma página de uma folha de propriedades
Crie uma pasta PROPSHEETPAGE estrutura que contém dados sobre o ícone, rotular, modelo caixa diálogo, procedimento caixa diálogo e outros atributos de um folha de propriedades.
Chamar o CreatePropertySheet função e transmitir é um ponteiro para o PROPSHEETPAGE estrutura. A função retorna um HPROPSHEETPAGE identificador para a página propriedade.
Após ter definido uma ou mais páginas para um folha de propriedades, você pode criar um folha de propriedades. Uma maneira de criar um folha de propriedades é para especificar o endereço de um PROPSHEETHEADER estrutura em um chamar para o PropertySheet função. A estrutura define o ícone e título para o folha de propriedades e inclui um ponteiro para uma matriz de HPROPSHEETPAGE Alças. Quando PropertySheet Cria o folha de propriedades, ele inclui as páginas que são identificadas na matriz. A ordem da matriz determina a ordem das páginas na folha de propriedades.
Outra maneira de criar um folha de propriedades é para especificar uma matriz de PROPSHEETHEADER estruturas, instead of uma matriz de HPROPSHEETPAGE Alças. Neste maiúsculas e minúsculas, PropertySheet Cria alças para as páginas antes de que adiciona-los à folha de propriedades.
O PropertySheet função automaticamente define o tamanho e posição inicial de um folha de propriedades. A posição é baseada na posição do janela proprietária, e o tamanho se baseia a página maior que é especificada na matriz de páginas quando a folha de propriedades for criado.
Após ter criado um folha de propriedades, você pode adicionar e remover páginas usando a mensagem PSM_ADDPAGE. Observe que o tamanho do folha de propriedades não é possível alteração após ela ter sido criada, portanto, a nova página deve ser não maior que a página maior que atualmente é na folha de propriedades. Para remover uma página, use a mensagem PSM_REMOVEPAGE. Quando você definir uma página, você pode especificar o endereço das PropSheetPageProc função callback que chama o folha de propriedades quando ele cria ou remove a página. Usando PropSheetPageProc, você pode inicializar individual páginas em um folha de propriedades.
Para destruir uma página que foi criada usando o CreatePropertySheetPage função, mas que não foi adicionado para o folha de propriedades, use o DestroyPropertySheetPage função. Destruir um folha de propriedades destrói automaticamente todas as páginas que foram adicionadas. O OS destrói as páginas de ordem inversa daquela que está especificada na matriz que foi usado para criar as páginas.
Você especificar o título de uma folha de propriedades in a PROPSHEETHEADER estrutura que você usou para criar a folha de propriedades. Se a pasta dwFlags membro inclui o valor PSH_PROPTITLE, o folha de propriedades Adiciona o prefixo propriedades para o seqüência de caracteres título especificado. Use a mensagem PSM_SETTITLE para alteração de título após ter sido criado um folha de propriedades.
Por padrão, um folha de propriedades usa o seqüência de caracteres nome especificado no modelo para a caixa diálogo como o rotular para a página na folha de propriedades. Você pode substituir o seqüência de caracteres Nome, incluindo o valor PSP_USETITLE como o dwFlags membro das PROPSHEETPAGE estrutura que define a página. Quando PSP_USETITLE for especificada, o pszTitle membro deve conter o endereço da seqüência de caracteres rotular para a página.