Caixas de diálogo
Visão geral da tecnologia Caixas de Diálogo.
Para desenvolver caixas de diálogo, você precisa destes cabeçalhos:
Para obter diretrizes de programação para essa tecnologia, confira:
Funções
| AddRef O método IPrintDialogCallback::AddRef (commdlg.h) é o método AddRef de IUnknown, que diminui a contagem de referência de uma interface em um objeto COM. |
| AddRef O método IPrintDialogServices::AddRef (commdlg.h) é o método AddRef de IUnknown, que diminui a contagem de referência de uma interface em um objeto COM. |
| CDSIZEOF_STRUCT Obtém o tamanho de um struct até o membro especificado |
| ChooseColorA A função CHOOSECOLORA (ANSI) (commdlg.h) contém informações que a função ChooseColor usa para inicializar a caixa de diálogo Cor. |
| ChooseColorW Versão de cadeia de caracteres larga de ChooseColor |
| ChooseFontA Versão ASCII do ChooseFont |
| ChooseFontW Versão de cadeia de caracteres larga do ChooseFont |
| CommDlg_OpenSave_GetFilePathA Versão ASCII do CommDlg_OpenSave_GetFilePath |
| CommDlg_OpenSave_GetFilePathW Versão de cadeia de caracteres larga do CommDlg_OpenSave_GetFilePath |
| CommDlg_OpenSave_GetFolderIDList Recupera o endereço da lista de identificadores de item correspondente à pasta que uma caixa de diálogo Abrir ou Salvar como no estilo Explorer está aberta no momento. |
| CommDlg_OpenSave_GetFolderPathA Versão ASCII do CommDlg_OpenSave_GetFolderPath |
| CommDlg_OpenSave_GetFolderPathW Versão de cadeia de caracteres larga do CommDlg_OpenSave_GetFolderPath |
| CommDlg_OpenSave_GetSpecA Versão ASCII do CommDlg_OpenSave_GetSpec |
| CommDlg_OpenSave_GetSpecW Versão de cadeia de caracteres larga do CommDlg_OpenSave_GetSpec |
| CommDlg_OpenSave_HideControl Oculta o controle especificado em uma caixa de diálogo Abrir ou Salvar como no estilo Explorer. |
| CommDlg_OpenSave_SetControlText Define o texto do controle especificado em uma caixa de diálogo Abrir ou Salvar como no estilo Explorer. |
| CommDlg_OpenSave_SetDefExt Define a extensão de nome de arquivo padrão para uma caixa de diálogo Abrir ou Salvar como no estilo Explorer. |
| Commdlgextendederror A função CommDlgExtendedError (commdlg.h) retorna um código de erro de caixa de diálogo comum. |
| CreateDialogA Cria uma caixa de diálogo sem formatar a partir de um recurso de modelo de caixa de diálogo. A macro CreateDialog usa a função CreateDialogParam. (ANSI) |
| CreateDialogIndirectA Cria uma caixa de diálogo sem formatar a partir de um modelo de caixa de diálogo na memória. A macro CreateDialogIndirect usa a função CreateDialogIndirectParam. (ANSI) |
| CreateDialogIndirectParamA Cria uma caixa de diálogo sem formatar a partir de um modelo de caixa de diálogo na memória. (ANSI) |
| CreateDialogIndirectParamW Cria uma caixa de diálogo sem formatar a partir de um modelo de caixa de diálogo na memória. (Unicode) |
| CreateDialogIndirectW Cria uma caixa de diálogo sem formatar a partir de um modelo de caixa de diálogo na memória. A macro CreateDialogIndirect usa a função CreateDialogIndirectParam. (Unicode) |
| CreateDialogParamA Cria uma caixa de diálogo sem formatar a partir de um recurso de modelo de caixa de diálogo. (ANSI) |
| CreateDialogParamW Cria uma caixa de diálogo sem formatar a partir de um recurso de modelo de caixa de diálogo. (Unicode) |
| CreateDialogW Cria uma caixa de diálogo sem formatar a partir de um recurso de modelo de caixa de diálogo. A macro CreateDialog usa a função CreateDialogParam. (Unicode) |
| DefDlgProcA Chama o procedimento de janela da caixa de diálogo padrão para fornecer processamento padrão para todas as mensagens de janela que uma caixa de diálogo com uma classe de janela privada não processa. (ANSI) |
| DefDlgProcW Chama o procedimento de janela da caixa de diálogo padrão para fornecer processamento padrão para todas as mensagens de janela que uma caixa de diálogo com uma classe de janela privada não processa. (Unicode) |
| DialogBoxA Cria uma caixa de diálogo modal de um recurso de modelo de caixa de diálogo. DialogBox não retorna o controle até que a função de retorno de chamada especificada encerre a caixa de diálogo modal chamando a função EndDialog. (ANSI) |
| DialogBoxIndirectA Cria uma caixa de diálogo modal de um modelo de caixa de diálogo na memória. DialogBoxIndirect não retorna o controle até que a função de retorno de chamada especificada encerre a caixa de diálogo modal chamando a função EndDialog. (ANSI) |
| DialogBoxIndirectParamA Cria uma caixa de diálogo modal de um modelo de caixa de diálogo na memória. (ANSI) |
| DialogBoxIndirectParamW Cria uma caixa de diálogo modal de um modelo de caixa de diálogo na memória. (Unicode) |
| DialogBoxIndirectW Cria uma caixa de diálogo modal de um modelo de caixa de diálogo na memória. DialogBoxIndirect não retorna o controle até que a função de retorno de chamada especificada encerre a caixa de diálogo modal chamando a função EndDialog. (Unicode) |
| DialogBoxParamA Cria uma caixa de diálogo modal de um recurso de modelo de caixa de diálogo. (ANSI) |
| DialogBoxParamW Cria uma caixa de diálogo modal de um recurso de modelo de caixa de diálogo. (Unicode) |
| DialogBoxW Cria uma caixa de diálogo modal de um recurso de modelo de caixa de diálogo. DialogBox não retorna o controle até que a função de retorno de chamada especificada encerre a caixa de diálogo modal chamando a função EndDialog. (Unicode) |
| DLGPROC Função de retorno de chamada definida pelo aplicativo usada com as famílias createDialog e DialogBox de funções. |
| EndDialog Destrói uma caixa de diálogo modal, fazendo com que o sistema encerre qualquer processamento para a caixa de diálogo. |
| FindTextA Cria uma caixa de diálogo Localizar sem formatação definida pelo sistema que permite que o usuário especifique uma cadeia de caracteres a ser pesquisada e opções a serem usadas ao pesquisar texto em um documento. (ANSI) |
| FindTextW Cria uma caixa de diálogo Localizar sem formatação definida pelo sistema que permite que o usuário especifique uma cadeia de caracteres a ser pesquisada e opções a serem usadas ao pesquisar texto em um documento. (Unicode) |
| GetCurrentDevMode Preenche uma estrutura DEVMODE com informações sobre a impressora selecionada no momento para uso com PrintDlgEx. |
| GetCurrentPortName Recupera o nome da porta atual para uso com PrintDlgEx. |
| GetCurrentPrinterName Recupera o nome da impressora selecionada no momento, para uso com PrintDlgEx. |
| Getdialogbaseunits Recupera as unidades base da caixa de diálogo do sistema, que são a largura média e a altura dos caracteres na fonte do sistema. |
| GetDlgCtrlID Recupera o identificador do controle especificado. |
| Getdlgitem Recupera um identificador para um controle na caixa de diálogo especificada. |
| GetDlgItemInt Converte o texto de um controle especificado em uma caixa de diálogo em um valor inteiro. |
| GetDlgItemTextA Recupera o título ou texto associado a um controle em uma caixa de diálogo. (ANSI) |
| GetDlgItemTextW Recupera o título ou texto associado a um controle em uma caixa de diálogo. (Unicode) |
| GetFileTitleA Recupera o nome do arquivo especificado. (ANSI) |
| GetFileTitleW Recupera o nome do arquivo especificado. (Unicode) |
| GetNextDlgGroupItem Recupera um identificador para o primeiro controle em um grupo de controles que precede (ou segue) o controle especificado em uma caixa de diálogo. |
| GetNextDlgTabItem Recupera um identificador para o primeiro controle que tem o estilo WS_TABSTOP que precede (ou segue) o controle especificado. |
| GetOpenFileNameA Cria uma caixa de diálogo Abrir que permite que o usuário especifique a unidade, o diretório e o nome de um arquivo ou conjunto de arquivos a serem abertos. (ANSI) |
| GetOpenFileNameW Cria uma caixa de diálogo Abrir que permite que o usuário especifique a unidade, o diretório e o nome de um arquivo ou conjunto de arquivos a serem abertos. (Unicode) |
| GetSaveFileNameA Cria uma caixa de diálogo Salvar que permite que o usuário especifique a unidade, o diretório e o nome de um arquivo a ser salvo. (ANSI) |
| GetSaveFileNameW Cria uma caixa de diálogo Salvar que permite que o usuário especifique a unidade, o diretório e o nome de um arquivo a ser salvo. (Unicode) |
| HandleMessage Chamado por PrintDlgEx para dar ao seu aplicativo a oportunidade de manipular mensagens enviadas para a caixa de diálogo filho na parte inferior da página Geral da Folha de Propriedades de Impressão. |
| InitDone Chamado por PrintDlgEx quando o sistema terminar de inicializar a página Geral da Folha de Propriedades de Impressão. |
| IsDialogMessageA Determina se uma mensagem é destinada à caixa de diálogo especificada e, se for, processa a mensagem. (ANSI) |
| IsDialogMessageW Determina se uma mensagem é destinada à caixa de diálogo especificada e, se for, processa a mensagem. (Unicode) |
| LPCCHOOKPROC Recebe mensagens ou notificações destinadas ao procedimento da caixa de diálogo padrão da caixa de diálogo Cor. Essa é uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca que é usada com a função ChooseColor. |
| LPCFHOOKPROC Recebe mensagens ou notificações destinadas ao procedimento da caixa de diálogo padrão da caixa de diálogo Fonte. Este é um procedimento de retorno de chamada definido pelo aplicativo ou definido pela biblioteca que é usado com a função ChooseFont. |
| LPFRHOOKPROC Recebe mensagens ou notificações destinadas ao procedimento da caixa de diálogo padrão da caixa de diálogo Localizar ou Substituir. |
| LPOFNHOOKPROC Recebe mensagens de notificação enviadas da caixa de diálogo. |
| LPPAGEPAINTHOOK Recebe mensagens que permitem personalizar o desenho da página de exemplo na caixa de diálogo Configurar Página. O procedimento de gancho PagePaintHook é uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca usada com a função PageSetupDlg. |
| LPPAGESETUPHOOK Recebe mensagens ou notificações destinadas ao procedimento da caixa de diálogo padrão da caixa de diálogo Configuração de Página. O procedimento de gancho PageSetupHook é uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca usada com a função PageSetupDlg. |
| LPPRINTHOOKPROC Recebe mensagens ou notificações destinadas ao procedimento da caixa de diálogo padrão da caixa de diálogo Imprimir. Essa é uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca que é usada com a função PrintDlg. |
| LPSETUPHOOKPROC Uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca usada com a função PrintDlg. O procedimento de gancho recebe mensagens ou notificações destinadas ao procedimento da caixa de diálogo padrão da caixa de diálogo Configurar Impressão. |
| MapDialogRect Converte as unidades da caixa de diálogo especificadas em unidades de tela (pixels). |
| Messagebox A função MessageBox exibe uma caixa de diálogo modal que contém um ícone do sistema, um conjunto de botões e uma breve mensagem específica do aplicativo. |
| MessageBoxA Exibe uma caixa de diálogo modal que contém um ícone do sistema, um conjunto de botões e uma breve mensagem específica do aplicativo, como status ou informações de erro. A caixa de mensagem retorna um valor inteiro que indica qual botão o usuário clicou. (MessageBoxA) |
| MessageBoxExA Cria, exibe e opera uma caixa de mensagem. (ANSI) |
| MessageBoxExW Cria, exibe e opera uma caixa de mensagem. (Unicode) |
| MessageBoxIndirectA Cria, exibe e opera uma caixa de mensagem. A caixa de mensagem contém texto e título de mensagem definidos pelo aplicativo, qualquer ícone e qualquer combinação de botões de push predefinidos. (ANSI) |
| MessageBoxIndirectW Cria, exibe e opera uma caixa de mensagem. A caixa de mensagem contém texto e título de mensagem definidos pelo aplicativo, qualquer ícone e qualquer combinação de botões de push predefinidos. (Unicode) |
| MessageBoxW A função MessageBoxW (Unicode) exibe uma caixa de diálogo modal que contém um ícone do sistema, um conjunto de botões e uma breve mensagem específica do aplicativo. |
| MSGBOXCALLBACK Uma função de retorno de chamada, que você define em seu aplicativo, que processa eventos de ajuda para a caixa de mensagem. |
| PageSetupDlgA Versão ASCII de PageSetupDlg |
| PageSetupDlgW Versão de cadeia de caracteres larga de PageSetupDlg |
| PrintDlgA Versão ASCII do PrintDlg |
| PrintDlgExA Versão ASCII de PrintDlgEx |
| PrintDlgExW Versão de cadeia de caracteres larga de PrintDlgEx |
| PrintDlgW Versão de cadeia de caracteres larga de PrintDlg |
| QueryInterface O método IPrintDialogCallback::QueryInterface (commdlg.h) é o método QueryInterface de IUnknown, que consulta um objeto COM em busca de um ponteiro. |
| QueryInterface O método IPrintDialogServices::QueryInterface (commdlg.h) é o método QueryInterface de IUnknown, que consulta um objeto COM em busca de um ponteiro. |
| Versão O método IPrintDialogCallback::Release (commdlg.h) é o método Release de IUnknown, que diminui a contagem de referência de uma interface em um objeto COM. |
| Versão O método IPrintDialogServices::Release (commdlg.h) é o método Release do IUnknown, que diminui a contagem de referência para uma interface em um objeto COM. |
| ReplaceTextA Cria uma caixa de diálogo sem formatação definida pelo sistema que permite que o usuário especifique uma cadeia de caracteres para pesquisar e uma cadeia de caracteres de substituição, bem como opções para controlar as operações de localização e substituição. (ANSI) |
| ReplaceTextW Cria uma caixa de diálogo sem formatação definida pelo sistema que permite que o usuário especifique uma cadeia de caracteres para pesquisar e uma cadeia de caracteres de substituição, bem como opções para controlar as operações de localização e substituição. (Unicode) |
| Selectionchange Chamado por PrintDlgEx quando o usuário seleciona uma impressora diferente na lista de impressoras instaladas na página Geral da Folha de Propriedades de Impressão. |
| SendDlgItemMessageA Envia uma mensagem para o controle especificado em uma caixa de diálogo. (ANSI) |
| SendDlgItemMessageW Envia uma mensagem para o controle especificado em uma caixa de diálogo. (Unicode) |
| SetDlgItemInt Define o texto de um controle em uma caixa de diálogo para a representação de cadeia de caracteres de um valor inteiro especificado. |
| SetDlgItemTextA Define o título ou texto de um controle em uma caixa de diálogo. (ANSI) |
| SetDlgItemTextW Define o título ou texto de um controle em uma caixa de diálogo. (Unicode) |
Interfaces
| IPrintDialogCallback Fornece métodos que permitem que um aplicativo receba notificações e mensagens da função PrintDlgEx enquanto a Folha de Propriedades de Impressão é exibida. |
| IPrintDialogServices Fornece métodos que habilitam um aplicativo usando a função PrintDlgEx para recuperar informações sobre a impressora selecionada no momento. |
Estruturas
| CHOOSEFONTA Contém informações que a função ChooseFont usa para inicializar a caixa de diálogo Fonte. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre a seleção do usuário nessa estrutura. (ANSI) |
| CHOOSEFONTW Contém informações que a função ChooseFont usa para inicializar a caixa de diálogo Fonte. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre a seleção do usuário nessa estrutura. (Unicode) |
| DEVNAMES Contém cadeias de caracteres que identificam o driver, o dispositivo e os nomes de porta de saída de uma impressora. |
| DLGITEMTEMPLATE Define as dimensões e o estilo de um controle em uma caixa de diálogo. Uma ou mais dessas estruturas são combinadas com uma estrutura DLGTEMPLATE para formar um modelo padrão para uma caixa de diálogo. |
| DLGTEMPLATE Define as dimensões e o estilo de uma caixa de diálogo. |
| FINDREPLACEA Contém informações que as funções FindText e ReplaceText usam para inicializar as caixas de diálogo Localizar e Substituir. (ANSI) |
| FINDREPLACEW Contém informações que as funções FindText e ReplaceText usam para inicializar as caixas de diálogo Localizar e Substituir. (Unicode) |
| MSGBOXPARAMSA Contém informações usadas para exibir uma caixa de mensagem. A função MessageBoxIndirect usa essa estrutura. (ANSI) |
| MSGBOXPARAMSW Contém informações usadas para exibir uma caixa de mensagem. A função MessageBoxIndirect usa essa estrutura. (Unicode) |
| OFNOTIFYA Contém informações sobre uma mensagem de WM_NOTIFY enviada a um procedimento de gancho OFNHookProc para uma caixa de diálogo Abrir ou Salvar como. O parâmetro lParam da mensagem WM_NOTIFY é um ponteiro para uma estrutura OFNOTIFY. (ANSI) |
| OFNOTIFYEXA Contém informações sobre uma mensagem de notificação CDN_INCLUDEITEM. (ANSI) |
| OFNOTIFYEXW Contém informações sobre uma mensagem de notificação CDN_INCLUDEITEM. (Unicode) |
| OFNOTIFYW Contém informações sobre uma mensagem de WM_NOTIFY enviada a um procedimento de gancho OFNHookProc para uma caixa de diálogo Abrir ou Salvar como. O parâmetro lParam da mensagem WM_NOTIFY é um ponteiro para uma estrutura OFNOTIFY. (Unicode) |
| OPENFILENAME_NT4A A estrutura de OPENFILENAME_NT4 é idêntica a OPENFILENAME com _WIN32_WINNT definido como 0x0400. (ANSI) |
| OPENFILENAME_NT4W A estrutura de OPENFILENAME_NT4 é idêntica a OPENFILENAME com _WIN32_WINNT definido como 0x0400. (Unicode) |
| OPENFILENAMEA Contém informações que as funções GetOpenFileName e GetSaveFileName usam para inicializar uma caixa de diálogo Abrir ou Salvar como. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre a seleção do usuário nessa estrutura. (ANSI) |
| OPENFILENAMEW Contém informações que as funções GetOpenFileName e GetSaveFileName usam para inicializar uma caixa de diálogo Abrir ou Salvar como. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre a seleção do usuário nessa estrutura. (Unicode) |
| PAGESETUPDLGA Contém informações que a função PageSetupDlg usa para inicializar a caixa de diálogo Configurar Página. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre os parâmetros de página definidos pelo usuário nessa estrutura. (ANSI) |
| PAGESETUPDLGW Contém informações que a função PageSetupDlg usa para inicializar a caixa de diálogo Configurar Página. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre os parâmetros de página definidos pelo usuário nessa estrutura. (Unicode) |
| PRINTDLGA Contém informações que a função PrintDlg usa para inicializar a caixa de diálogo Imprimir. Depois que o usuário fecha a caixa de diálogo, o sistema usa essa estrutura para retornar informações sobre as seleções do usuário. (ANSI) |
| PRINTDLGEXA Contém informações que a função PrintDlgEx usa para inicializar a folha de propriedades Print. Depois que o usuário fecha a folha de propriedades, o sistema usa essa estrutura para retornar informações sobre as seleções do usuário. (ANSI) |
| PRINTDLGEXW Contém informações que a função PrintDlgEx usa para inicializar a folha de propriedades Print. Depois que o usuário fecha a folha de propriedades, o sistema usa essa estrutura para retornar informações sobre as seleções do usuário. (Unicode) |
| PRINTDLGW Contém informações que a função PrintDlg usa para inicializar a caixa de diálogo Imprimir. Depois que o usuário fecha a caixa de diálogo, o sistema usa essa estrutura para retornar informações sobre as seleções do usuário. (Unicode) |
| PRINTPAGERANGE Representa um intervalo de páginas em um trabalho de impressão. Um trabalho de impressão pode ter mais de um intervalo de páginas. Essas informações são fornecidas na estrutura PRINTDLGEX ao chamar a função PrintDlgEx. |