Folha de propriedades

Esta seção contém informações sobre elementos de programação usados com folhas de propriedades.

Visões gerais

Tópico	Contents
Sobre as folhas de propriedades	Uma folha de propriedades é uma janela que permite ao usuário exibir e editar as propriedades de um item.
Criando assistentes	Um assistente é um tipo de folha de propriedades que fornece uma maneira simples e poderosa de orientar os usuários através de um procedimento.
Usando folhas de propriedades	Esta seção fornece detalhes de implementação e código de exemplo para trabalhar com folhas de propriedades.

Funções

Tópico	Contents
AddPropSheetPageProc	Especifica uma função de retorno de chamada definida pelo aplicativo que uma extensão de folha de propriedades usa para adicionar uma página a uma folha de propriedades.
CreatePropertySheetPage	Cria uma nova página para uma folha de propriedades.
DestroyPropertySheetPage	Destrói uma página de folha de propriedades. Um aplicativo deve chamar essa função para páginas que não foram passadas para a função PropertySheet .
Folha de Propriedades	Cria uma folha de propriedades e adiciona as páginas definidas na estrutura de cabeçalho da folha de propriedades especificada.
PropSheetPageProc	Especifica uma função de retorno de chamada definida pelo aplicativo que uma folha de propriedades chama quando uma página é criada e quando está prestes a ser destruída. Um aplicativo pode usar essa função para executar operações de inicialização e limpeza para a página.
PropSheetProc	Uma função de retorno de chamada definida pelo aplicativo que o sistema chama quando a folha de propriedades está sendo criada e inicializada.

Mensagens

Tópico	Contents
PSM_ADDPAGE	Adiciona uma nova página ao final de uma folha de propriedades existente. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_AddPage.
PSM_APPLY	Simula a seleção do botão Aplicar , indicando que uma ou mais páginas foram alteradas e as alterações precisam ser validadas e registradas.
PSM_CANCELTOCLOSE	Enviado por um aplicativo quando ele tiver realizado alterações desde a notificação de PSN_APPLY mais recente que não pode ser cancelada. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_CancelToClose.
PSM_CHANGED	Informa a uma folha de propriedades que as informações em uma página foram alteradas. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_Changed.
PSM_ENABLEWIZBUTTONS	Habilita ou desabilita qualquer um dos botões padrão em um assistente Aero. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_EnableWizButtons.
PSM_GETCURRENTPAGEHWND	Recupera um identificador para a janela da página atual de uma folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_GetCurrentPageHwnd.
PSM_GETRESULT	Usado por folhas de propriedades sem janela restrita para recuperar as informações retornadas às folhas de propriedades modais por PropertySheet. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_GetResult.
PSM_GETTABCONTROL	Recupera o identificador para o controle de guia de uma folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_GetTabControl.
PSM_HWNDTOINDEX	Pega o identificador de janela da página da folha de propriedades e retorna seu índice baseado em zero. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_HwndToIndex.
PSM_IDTOINDEX	Pega a ID do recurso de uma página de folha de propriedades e retorna seu índice baseado em zero. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_IdToIndex.
PSM_INDEXTOHWND	Pega o índice de uma página de folha de propriedades e retorna seu identificador de janela. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_IndexToHwnd.
PSM_INDEXTOID	Pega o índice de uma página de folha de propriedades e retorna sua ID de recurso. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_IndexToId.
PSM_INDEXTOPAGE	Pega o índice de uma página de folha de propriedades e retorna seu identificador HPROPSHEETPAGE. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_IndexToPage.
PSM_INSERTPAGE	Insere uma nova página em uma folha de propriedades existente. A página pode ser inserida em um índice especificado ou após uma página especificada. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_InsertPage.
PSM_ISDIALOGMESSAGE	Passa uma mensagem para uma caixa de diálogo de folha de propriedades e indica se a caixa de diálogo processou a mensagem. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_IsDialogMessage.
PSM_PAGETOINDEX	Usa o identificador HPROPSHEETPAGE da página da folha de propriedades e retorna seu índice baseado em zero. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_PageToIndex.
PSM_PRESSBUTTON	Simula a seleção de um botão de folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_PressButton.
PSM_QUERYSIBLINGS	Enviado para uma folha de propriedades, que encaminha a mensagem para cada uma de suas páginas. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_QuerySiblings.
PSM_REBOOTSYSTEM	Indica que o sistema precisa ser reiniciado para que as alterações entrem em vigor. Você pode enviar a mensagem de PSM_REBOOTSYSTEM explicitamente ou usando a macro PropSheet_RebootSystem.
PSM_RECALCPAGESIZES	Recalcula o tamanho da página de uma folha de propriedades padrão ou do assistente depois que as páginas são adicionadas ou removidas. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_RecalcPageSizes.
PSM_REMOVEPAGE	Remove uma página de uma folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_RemovePage.
PSM_RESTARTWINDOWS	Indica que o Windows precisa ser reiniciado para que as alterações entrem em vigor.
PSM_SETBUTTONTEXT	Define o texto em um botão em um assistente Aero. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_SetButtonText.
PSM_SETCURSEL	Ativa a página especificada em uma folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_SetCurSel.
PSM_SETCURSELID	Ativa a página fornecida em uma folha de propriedades com base no identificador de recurso da página. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_SetCurSelByID.
PSM_SETFINISHTEXT	Define o texto do botão Concluir em um assistente, mostra e habilita o botão e oculta os botões Avançar e Voltar. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_SetFinishText.
PSM_SETHEADERBITMAP	Esta mensagem não está implementada.
PSM_SETHEADERBITMAPRESOURCE	Esta mensagem não está implementada.
PSM_SETHEADERSUBTITLE	Define o texto da legenda para o cabeçalho da página interior de um assistente. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_SetHeaderSubTitle.
PSM_SETHEADERTITLE	Define o texto do título para o cabeçalho da página interior de um assistente. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_SetHeaderTitle.
PSM_SETNEXTTEXT	Define o texto do botão Avançar em um assistente. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_SetNextText.
PSM_SETTITLE	Define o título de uma folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_SetTitle.
PSM_SETWIZBUTTONS	Habilita ou desabilita os botões Voltar, Avançar e Concluir em um assistente. Você também pode usar a macro PropSheet_SetWizButtons para postar a mensagem.
PSM_SHOWWIZBUTTONS	Mostra ou oculta botões em um assistente. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_ShowWizButtons.
PSM_UNCHANGED	Informa a uma folha de propriedades que as informações em uma página foram revertidas para o estado salvo anteriormente. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_UnChanged.

Notifications

Tópico	Contents
PSN_APPLY	Enviado para todas as páginas da folha de propriedades para indicar que o usuário clicou no botão OK, Fechar ou Aplicar e deseja que todas as alterações entrem em vigor. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY .
PSN_GETOBJECT	Enviado por uma folha de propriedades para solicitar um objeto de destino solto quando o cursor passa sobre um dos botões do controle de guia.
PSN_HELP	Notifica uma página de que o usuário clicou no botão Ajuda. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
PSN_KILLACTIVE	Notifica uma página de que ela está prestes a perder a ativação porque outra página está sendo ativada ou porque o usuário clicou no botão OK . Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
PSN_QUERYCANCEL	Indica que o usuário cancelou a folha de propriedades. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
PSN_QUERYINITIALFOCUS	Enviado por uma folha de propriedades para fornecer a uma página de folha de propriedades uma oportunidade de especificar qual controle de caixa de diálogo deve receber o foco inicial. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY .
PSN_RESET	Notifica uma página de que a folha de propriedades está prestes a ser destruída. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
PSN_SETACTIVE	Notifica uma página de que ela está prestes a ser ativada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
PSN_TRANSLATEACCELERATOR	Notifica uma folha de propriedades de que uma mensagem de teclado foi recebida. Ele fornece à página uma oportunidade de fazer tradução privada do acelerador de teclado. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY .
PSN_WIZBACK	Notifica uma página de que o usuário clicou no botão Voltar em um assistente. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
PSN_WIZFINISH	Notifica uma página de que o usuário clicou no botão Concluir em um assistente. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
PSN_WIZNEXT	Notifica uma página de que o usuário clicou no botão Avançar em um assistente. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.

Estruturas

Tópico	Contents
PROPSHEETHEADER	Define o quadro e as páginas de uma folha de propriedades.
PROPSHEETPAGE	Define uma página em uma folha de propriedades.
PSHNOTIFY	Contém informações para os códigos de notificação da folha de propriedades.