Compartilhar via

Folha de propriedades

  • Artigo

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

Súmulas

Tópico Conteúdo
sobre folhas de propriedades Uma folha de propriedades é uma janela que permite que o usuário exiba e edite 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 por meio 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 Conteúdo
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çãoPropertySheet.
PropertySheet 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 ela 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 Conteúdo
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 executa 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 do 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 modeless para recuperar as informações retornadas às folhas de propriedades modais PropertySheet. Você pode enviar essa mensagem explicitamente ou usar a macro PropSheet_GetResult.
PSM_GETTABCONTROL Recupera o identificador para o controle de tabulação de uma folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_GetTabControl.
PSM_HWNDTOINDEX Usa 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 Usa 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 Usa 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 Usa 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 Usa 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 Enviada 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 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 assistente após páginas terem sido 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 do 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 Próximo e Voltar. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_SetFinishText.
PSM_SETHEADERBITMAP Esta mensagem não é implementada.
PSM_SETHEADERBITMAPRESOURCE Esta mensagem não é implementada.
PSM_SETHEADERSUBTITLE Define o texto do subtítulo 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 Próximo 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, Próximoe 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.

Notificações

Tópico Conteúdo
PSN_APPLY Enviado para cada página 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. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY.
PSN_GETOBJECT Enviado por uma folha de propriedades para solicitar um objeto de destino suspenso quando o cursor passa sobre um dos botões do controle de tabulação.
PSN_HELP Notifica uma página 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 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 Enviada por uma folha de propriedades para fornecer a uma página de folha de propriedades uma oportunidade para especificar qual controle de caixa de diálogo deve receber o foco inicial. Essa notificação é enviada na forma de uma mensagem de 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 oferece à página uma oportunidade de fazer a tradução do acelerador de teclado privado. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY.
PSN_WIZBACK Notifica uma página em 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 em 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 Próximo em um assistente. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.

Estruturas

Tópico Conteúdo
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.