Compartilhar via


Estilos de caixa de diálogo

A tabela a seguir lista os estilos de caixa de diálogo que você pode especificar ao criar uma caixa de diálogo. Você pode usar esses estilos em chamadas para as funções CreateWindow e CreateWindowEx , no membro de estilo das estruturas DLGTEMPLATE e DLGTEMPLATEEX e na instrução de uma definição de caixa de diálogo em um arquivo de recurso.

Constante Descrição
DS_3DLOOK
Obsoleto. O sistema aplica automaticamente a aparência tridimensional às caixas de diálogo criadas por aplicativos.
DS_ABSALIGN
Indica que as coordenadas da caixa de diálogo são coordenadas de tela. Se esse estilo não for especificado, as coordenadas serão coordenadas do cliente.
DS_CENTER
Centraliza a caixa de diálogo na área de trabalho do monitor que contém a janela do proprietário. Se nenhuma janela de proprietário for especificada, a caixa de diálogo será centralizada na área de trabalho de um monitor determinado pelo sistema. A área de trabalho é a área não obscurecida pela barra de tarefas ou por nenhuma barra de aplicativos.
DS_CENTERMOUSE
Centraliza a caixa de diálogo no cursor do mouse.
DS_CONTEXTHELP
Inclui um ponto de interrogação na barra de título da caixa de diálogo. Quando o usuário clica no ponto de interrogação, o cursor muda para um ponto de interrogação com um ponteiro. Se o usuário clicar em um controle na caixa de diálogo, o controle receberá uma mensagem WM_HELP . O controle deve passar a mensagem para o procedimento da caixa de diálogo, que deve chamar a função usando o comando HELP_WM_HELP . O aplicativo de ajuda exibe uma janela pop-up que normalmente contém ajuda para o controle.
Observe que DS_CONTEXTHELP é apenas um espaço reservado. Quando a caixa de diálogo é criada, o sistema verifica se há DS_CONTEXTHELP e, se estiver lá, adiciona WS_EX_CONTEXTHELP ao estilo estendido da caixa de diálogo. WS_EX_CONTEXTHELP não pode ser usado com os estilos WS_MAXIMIZEBOX ou WS_MINIMIZEBOX .
DS_CONTROL
Cria uma caixa de diálogo que funciona bem como uma janela filho de outra caixa de diálogo, assim como uma página em uma folha de propriedades. Esse estilo permite que o usuário tabe entre as janelas de controle de uma caixa de diálogo filho, use suas teclas de acelerador e assim por diante.
DS_FIXEDSYS
Faz com que a caixa de diálogo use o SYSTEM_FIXED_FONT em vez do SYSTEM_FONT padrão. Essa é uma fonte de monospace compatível com a fonte System em versões de 16 bits do Windows anteriores à 3.0.
DS_LOCALEDIT
Aplica-se somente a aplicativos de 16 bits. Esse estilo direciona os controles de edição na caixa de diálogo para alocar memória do segmento de dados do aplicativo. Caso contrário, os controles de edição alocam armazenamento de um objeto de memória global.
DS_MODALFRAME
Cria uma caixa de diálogo com um quadro de caixa de diálogo modal que pode ser combinado com uma barra de título e um menu de janela especificando os estilos WS_CAPTION e WS_SYSMENU .
DS_NOFAILCREATE
Cria a caixa de diálogo mesmo que ocorram erros, por exemplo, se uma janela filho não puder ser criada ou se o sistema não puder criar um segmento de dados especial para um controle de edição.
DS_NOIDLEMSG
Suprime WM_ENTERIDLE mensagens que o sistema enviaria para o proprietário da caixa de diálogo enquanto a caixa de diálogo é exibida.
DS_SETFONT
Indica que o cabeçalho do modelo da caixa de diálogo (padrão ou estendido) contém dados adicionais especificando a fonte a ser usada para texto na área do cliente e controles da caixa de diálogo. Se possível, o sistema seleciona uma fonte de acordo com os dados de fonte especificados. O sistema passa um identificador para a fonte para a caixa de diálogo e para cada controle enviando-lhes a mensagem WM_SETFONT . Para obter descrições do formato desses dados de fonte, consulte DLGTEMPLATE e DLGTEMPLATEEX.
Se nem DS_SETFONT nem DS_SHELLFONT for especificado, o modelo da caixa de diálogo não incluirá os dados da fonte.
DS_SETFOREGROUND
Faz com que o sistema use a função SetForegroundWindow para colocar a caixa de diálogo em primeiro plano. Esse estilo é útil para caixas de diálogo modais que exigem atenção imediata do usuário, independentemente de a janela do proprietário ser a janela em primeiro plano.
O sistema restringe quais processos podem definir a janela em primeiro plano. Para obter mais informações, consulte Foreground e Background Windows.
DS_SHELLFONT
Indica que a caixa de diálogo deve usar a fonte do sistema. O membro typeface do modelo de caixa de diálogo estendida deve ser definido como MS Shell Dlg. Caso contrário, esse estilo não terá efeito. Também é recomendável que você use o recurso DIALOGEX, em vez do recurso DIALOG. Para obter mais informações, consulte Fontes da caixa de diálogo.
O sistema seleciona uma fonte usando os dados de fonte especificados nos membros pointsize, weight e itálico . O sistema passa um identificador para a fonte para a caixa de diálogo e para cada controle enviando-lhes a mensagem WM_SETFONT . Para obter descrições do formato desses dados de fonte, consulte DLGTEMPLATEEX.
Se nem DS_SHELLFONT nem DS_SETFONT for especificado, o modelo de caixa de diálogo estendida não incluirá os dados da fonte.
DS_SYSMODAL
Esse estilo é obsoleto e está incluído para compatibilidade com versões de 16 bits do Windows. Se você especificar esse estilo, o sistema criará a caixa de diálogo com o estilo WS_EX_TOPMOST . Esse estilo não impede que o usuário acesse outras janelas na área de trabalho.
Não combine esse estilo com o estilo DS_CONTROL .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)