Folha de propriedades

  • Artigo

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.