CreateWindowEx

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/9/2008

Essa função cria um sobreposto, pop-up ou janela filho com um estendido estilo; caso contrário, essa função é idêntica de CreateWindow função.

Syntax

HWND CreateWindowEx(
  DWORD dwExStyle, 
  LPCTSTR lpClassName, 
  LPCTSTR lpWindowName, 
  DWORD dwStyle, 
  int x, 
  int y, 
  int nWidth, 
  int nHeight, 
  HWND hWndParent, 
  HMENU hMenu, 
  HINSTANCE hInstance, 
  LPVOID lpParam 
);

Parameters

dwExStyle
[no] Especifica o estendido estilo da janela. Este parâmetro pode ser uma dos seguinte valores:

Valor	Descrição
WS_EX_ACCEPTFILES	Especifica que uma janela criada com este estilo aceita arrastar-arquivos ato de soltar.
WS_EX_CAPTIONOKBTN	Adiciona um OK botão na barra de legenda.
WS_EX_CLIENTEDGE	Especifica que uma janela tem uma borda com um baixo relevo borda.
WS_EX_CONTEXTMENU	Adiciona um botão Ajuda a barra de legenda.
WS_EX_DLGMODALFRAME	Cria uma janela que tenha um duplo borda; a janela opcionalmente, pode, ser criada com um barra de título, especificando o estilo WS_CAPTION in a dwStyle parâmetro.
WS_EX_INK	Indica que não beeping usar como padrão som é gerado no clicar na janela.
WS_EX_LAYOUTRTL	Cria uma janela cuja origem horizontal consta o direito borda. Aumentando avançado valores horizontal para a esquerda.
WS_EX_LTRREADING	O texto janela é exibido usando ESQUERDA - para - direito lendo-propriedades ordem. Essa é a usar como padrão.
WS_EX_NOACTIVATE	Um janela de alto nível criados com este estilo não pode ser ativada. Se um janela filho tiver esse estilo, tocar ele não causar sua de alto nível pai para ser ativado. Uma janela que tenha esse estilo recebe eventos caneta, mas ele nem seus janelas filho podem get o foco. Suportados na Windows CE 2.0 e posteriores.
WS_EX_NOANIMATION	Uma janela criada com este estilo não apresentação animada Explodindo e imploding retângulos e não tiver um botão na barra de tarefas. Suportados na Windows CE 2.0 e posteriores.
WS_EX_NODRAG	Uma janela criada com este estilo não pode ser arrastada usando um mouse ou caneta.
WS_EX_NOINHERITLAYOUT	Uma janela criada com este estilo não transmitir seu layout janela para suas janelas filho.
WS_EX_OVERLAPPEDWINDOW	Combina os estilos WS_EX_CLIENTEDGE e WS_EX_WINDOWEDGE.
WS_EX_PALETTEWINDOW	Combina os estilos WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW e WS_EX_TOPMOST.
WS_EX_RTLREADING	Se a linguagem shell for hebraico, árabe ou outra linguagem que ofereça suporte a leitura - ordem alinhamento, o texto janela é exibido com leitura da direita para a esquerda - propriedades ordem. Para outros idiomas, o estilo é ignorado.
WS_EX_STATICEDGE	Cria uma janela com um tridimensional estilo de borda deve ser usada para itens que não não aceitar entrada usuário.
WS_EX_TOOLWINDOW	Cria um janela de ferramentas; Isto é, uma janela deve ser usado como um flutuante barra de ferramentas. Um janela de ferramentas não aparece na barra de tarefas ou de diálogo que aparece quando o usuário pressiona ALT+TAB. Se um janela de ferramentas tem um menu sistema, o ícone não será exibido na barra de título.
WS_EX_TOPMOST	Especifica que uma janela criada com este estilo deve ser colocada acima de todos os não-superior Windows e deve permanecer acima-las, mesmo quando a janela é desativada. Para adicionar ou remover esse estilo, use o SetWindowPos função.
WS_EX_WINDOWEDGE	Especifica que uma janela tem uma borda com uma borda elevada.

Boolean
[no] Ponteiro longo em um átomo ou seqüência de caracteres NULL-Terminated. Se este parâmetro for um átomo, ele deverá ser um átomo global criado por um chamar anterior para o RegisterClass função. O átomo deve estar de baixo-Palavra de ordem Boolean; o alto-palavra ordem deve ser zero.

Se Boolean é um seqüência de caracteres, ela especifica o nome classe janela. O nome classe pode ser qualquer nome registrado com o RegisterClass função ou de qualquer o controle predefinido-classe nomes.

lpWindowName
[no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o nome janela.

Se o estilo janela especifica um barra de título, o título janela apontado pelo lpWindowName é exibido na barra de título. Ao utilizar a CreateWindow Para criar controles, como botões, caixas verificar e os controles estáticos, use lpWindowName Para especificar o texto de controle.

dwStyle
[no] Especifica o estilo da janela que está sendo criada. Este parâmetro pode ser uma combinação da seguinte janela estilos, além de estilos controle indicado na seção de comentários.

Valor	Descrição
WS_BORDER	Cria uma janela que possui uma borda thin-Line.
WS_CAPTION	Cria uma janela que tenha um barra de título (inclui o estilo WS_BORDER).
Estilo	Cria um janela filho. Esse estilo não pode ser usado com o estilo WS_POPUP.
WS_CHILDWINDOW	Mesmo que o estilo estilo.
WS_CLIPCHILDREN	Exclui a área ocupada por janelas filho ao desenho ocorre dentro de janela pai. Esse estilo é usado ao criar a janela pai.
WS_CLIPSIBLINGS	Clipes relativo janelas filho para each other; Isto é, quando um determinado janela filho recebe um WM_PAINT mensagem, o estilo WS_CLIPSIBLINGS clipes todas as outras janelas filho sobrepostos fora da região do janela filho ser atualizado. Se WS_CLIPSIBLINGS não for especificado e sobreposição janelas filho, é possível, ao desenho dentro a área cliente de uma janela filho, para desenhar dentro a área cliente de uma janela filho vizinhos.
WS_DISABLED	Cria uma janela que inicialmente está desativada. Uma janela desativada não pode receber entrada a partir de usuário.
WS_DLGFRAME	Cria uma janela que possui uma borda de um estilo geralmente usado com caixas diálogo. Uma janela com esse estilo não pode ter um barra de título.
WS_GROUP	Especifica o primeiro controle de um GRUPO de controles. O GRUPO consiste esse controle primeiro e todos os controles definidos depois dela, up to o próximo controle com o estilo WS_GROUP. O primeiro controle em cada GRUPO normalmente tem o estilo WS_TABSTOP para que o usuário pode mover de GRUPO para GRUPO. O usuário pode subseqüentemente alteração a foco do teclado de um controle no GRUPO para o próximo controle na GRUPO usando teclas de direção.
WS_HSCROLL	Cria uma janela que tenha um barra de rolagem horizontal.
WS_MAXIMIZEBOX	Cria uma janela que tenha um Maximizar botão. Não pode ser combinado com o estilo WS_EX_CONTEXTHELP.
WS_MINIMIZEBOX	Cria uma janela que tenha um Minimizar botão. Não pode ser combinado com o estilo WS_EX_CONTEXTHELP.
WS_OVERLAPPED	Cria uma janela sobreposta. Uma janela sobreposta tem um barra de título e uma borda.
WS_OVERLAPPEDWINDOW	Cria uma janela sobreposta com os estilos WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX e WS_MAXIMIZEBOX. Observação Embora não seja WS_OVERLAPPEDWINDOW com suporte em Windows Embedded CE, a funcionalidade ainda pode ser obtida por adquirir um bit a bit OR dos sinalizadores estilo WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX e WS_MAXIMIZEBOX.
WS_POPUP	Cria um janela pop-up. Esse estilo não pode ser usado com o estilo estilo.
WS_POPUPWINDOW	Cria um janela pop-up com estilos WS_BORDER, WS_POPUP e WS_SYSMENU. Os estilos WS_CAPTION e WS_POPUPWINDOW devem ser combinados para tornar o menu janela visível.
WS_SIZEBOX	Cria uma janela que possui uma borda dimensionamento. Mesmo que o estilo WS_THICKFRAME.
WS_SYSMENU	Cria uma janela que tenha um Fechar (X) botão na non-client_area.
WS_TABSTOP	Especifica um controle que pode receber a foco do teclado quando o usuário pressiona a TAB chave. Pressione a TAB chave altera o foco do teclado para o próximo controle com o estilo WS_TABSTOP.
WS_THICKFRAME	Cria uma janela que possui uma borda dimensionamento. Mesmo que o estilo WS_SIZEBOX.
WS_VISIBLE	Cria uma janela que está visível inicialmente.
WS_VSCROLL	Cria uma janela que tenha um barra de rolagem vertical.

x
[no] Especifica o posição horizontal inicial da janela. Para um sobreposta ou janela pop-up, o x parâmetro é o x inicial-coordenar de upper-left corner a janela, em coordenadas Tela. Para um janela filho, x é o x-coordenar da upper-left corner de relativo a janela para o upper-left corner da área cliente da janela pai.

Se x está definido para CW_USEDEFAULT, o sistema seleciona a posição usar como padrão para upper-left corner a janela e ignora a y parâmetro. CW_USEDEFAULT é válido somente para Windows sobrepostos; Se for especificado para um pop-up ou janela filho, o x e y Os parâmetros são definidos como zero.

y
[no] Especifica o posição vertical inicial da janela. Para um sobreposta ou janela pop-up, o y parâmetro é o y inicial-coordenar de upper-left corner a janela, em coordenadas Tela. Para um janela filho, y é a y inicial-coordenar da upper-left corner de relativo a janela filho para o upper-left corner da área cliente da janela pai. Para uma caixa lista, y é a y inicial-coordenar da upper-left corner de relativo área cliente do o caixa de listagem para o upper-left corner da área cliente da janela pai.

Se uma janela sobreposta é criada com o conjunto bit de estilo WS_VISIBLE e o x parâmetro for definido para CW_USEDEFAULT, o sistema ignora a y parâmetro.

nWidth
[no] Especifica a largura, em unidades dispositivo, da janela. Para janelas sobrepostas, nWidth é largura a janela, em coordenadas Tela ou CW_USEDEFAULT. Se nWidth é CW_USEDEFAULT, o sistema seleciona uma usar como padrão largura e altura para a janela; a largura usar como padrão estende-se do x inicial-coordenadas para o direito borda da Tela; a altura usar como padrão estende-se de y inicial-coordenar para o parte superior da área de ícone. CW_USEDEFAULT é válido somente para Windows sobrepostos; Se CW_USEDEFAULT for especificada para um pop-up ou janela filho, o nWidth e nHeight parâmetro são definidas como zero.

nHeight
[no] Especifica a altura, em unidades dispositivo, da janela. Para janelas sobrepostas, nHeight é altura a janela, em coordenadas Tela. Se a pasta nWidth parâmetro for definido para CW_USEDEFAULT, ignora o sistema nHeight.

hWndParent
[no] Identificador para o pai ou janela proprietária da janela que está sendo criada. Para criar um janela filho ou uma janela de proprietário, fornecer uma válido identificador janela. Este parâmetro é opcional para pop-up windows.

hMenu
[no] Identificador para um menu, ou especifica um filho-identificador janela, depending on o estilo janela. Para um sobreposta ou janela pop-up, hMenu Identifica o menu a ser usado com a janela; Ela pode ser NULL se o menu classe for ser usado. Para um janela filho, hMenu Especifica o filho-identificador janela, um valor inteiro usado por um controle caixa de diálogo para notificar seu pai sobre eventos. O aplicativo determina o filho-identificador janela; Ele deve ser exclusivo para todas as janelas filho com o mesmo janela pai.

hInstance
[no] Identificador para a instância do módulo a ser associado com a janela.

lpParam
[no] Ponteiro longo para um valor a serem passados para a janela através de CREATESTRUCT estrutura passado a lParam parâmetro de WM_CREATE mensagem.

Return Value

Um identificador para a nova janela indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Windows Embedded CE não suporte autônomo barras menu. O hMenu parâmetro deve ser NULL, a menos que ele seja usado como um filho-identificador janela.

Para obter mais informações sobre como criar uma janela e descrições completas dos outros parâmetros de CreateWindowEx, consulte CreateWindow.

O seguinte dwExStyle Os sinalizadores não são com suporte:

WS_EX_ACCEPTFILES	WS_EX_NOPARENTNOTIFY
WS_EX_APPWINDOW	WS_EX_PALETTEWINDOW
WS_EX_CONTROLPARENT	WS_EX_RIGHT
WS_EX_LEFT	WS_EX_RIGHTSCROLLBAR
WS_EX_LEFTSCROLLBAR	WS_EX_RTLREADING
WS_EX_LTRREADING	WS_EX_TRANSPARENT
WS_EX_MDICHILD

Windows CE 1.0 não suporte o estilo WS_EX_TOPMOST. As versões 2.0 e posteriores não.

Windows CE 1.0 e 2.0 não suporte o estilo WS_EX_TOOLWINDOW. As versões 2,10 e posteriores não.

O seguinte dwStyle Os sinalizadores não são com suporte:

WS_CHILDWINDOW	WS_ICONIC
WS_MAXIMIZE	WS_MAXIMIZEBOX
WS_MINIMIZE	WS_MINIMIZEBOX
WS_OVERLAPPEDWINDOW	WS_POPUPWINDOW
WS_TILEDWINDOW	WS_THICKFRAME
WS_TILED

Todas as janelas implicitamente têm os estilos WS_CLIPSIBLINGS e WS_CLIPCHILDREN.

Windows CE 1.0 não suporte pertencentes janelas, Except for diálogo caixas.

Se a pasta hwndParent parâmetro não é NULL e WS_OVERLAPPED for especificada, Windows Embedded CE resolve a estar em conflito com fornecendo implicitamente o estilo estilo para a janela. Isso proporciona a janela um pai, não um proprietário. Portanto, um chamar para o GetWindow Retorna função com o conjunto valor GW_OWNER NULL.

O CreateWindowEx função envia mensagens WM_CREATE para a janela que está sendo criada.

O seguinte predefinidos controle classes podem ser especificadas na Boolean parâmetro. Observe o correspondente estilos controle você pode usar na dwStyle parâmetro.

BUTTON
Designa um pequeno janela filho retangular que representa um botão o usuário pode clique para ativá-la ou desativado. Controles de botão podem ser usados isoladamente ou em grupos, e eles podem ser rotulado ou aparecer sem texto. Botão controla aparência alteração geralmente quando o usuário clica-los. Para obter mais informações sobre os botões e os estilos você pode especificar in a dwStyle parâmetro, consulte Estilos de controle.

ComboBox
Designa um controle que consiste em uma caixa lista e um campo seleção semelhante a um controle editar. Ao usar esse estilo, um aplicativo deve ambos exibir o caixa de listagem em todas as vezes ou habilitar uma caixa drop-down list. Se a caixa lista estiver visível, digitar caracteres para o campo seleção realçará a primeira entrada caixa lista que coincida com os caracteres digitados. Inversamente, selecionando um item na caixa de lista exibe o texto selecionado no campo de seleção. Para uma tabela dos estilos de caixa de combinação é possível especificar in a dwStyle parâmetro, consulte Combo Box Styles.

Editar
Designa um janela filho retangular na qual o usuário pode texto tipo de teclado. O usuário seleciona o controle e concede a ele o foco do teclado clicando nele ou movendo a ele, pressionando a TAB chave. O usuário pode texto tipo quando o controle editar exibe um acento circunflexo piscando; Use o mouse para mover o cursor, selecionados caracteres a ser substituído, ou posição de cursor para inserir caracteres; ou use o BACKSPACE chave para excluir caracteres. Para obter mais informações sobre como editar controles e os estilos você pode especificar in a dwStyle parâmetro, consulte Estilos de controle.

ListBox
Designa uma lista de seqüências de caracteres caractere. Especifique esse controle sempre que um aplicativo deve apresentar uma lista de nomes, such as nomes de arquivos, da qual o usuário pode escolher. O usuário pode selecionar um seqüência de caracteres clicando-lo. Um seqüência de caracteres selecionado é realçado e uma notificação mensagem é passada para o janela pai. Para obter mais informações sobre caixas lista e os estilos você pode especificar in a dwStyle parâmetro, consulte Estilos de controle.

MDICLIENT
Designa um janela cliente MDI. Esta janela recebe as mensagens janelas filho. De que controle a aplicativo MDI Os bits recomendados estilo são WS_CLIPCHILDREN e estilo. Especifica os estilos WS_HSCROLL e WS_VSCROLL para criar um janela cliente MDI que permite que o usuário rolar Windows filho MDI em exibição.

SCROLLBAR
Designa um retângulo que contém um caixa de rolagem e tem setas direção em ambas as extremidades. O barra de rolagem envia uma mensagem notificação para seus janela pai sempre que o usuário clica o controle. O janela pai é responsável por atualizar a posição do caixa de rolagem, se necessário. Para obter mais informações sobre barras de rolagem e os estilos você pode especificar in a dwStyle parâmetro, consulte Estilos de controle.

Static
Designa um campo de texto simples, caixa ou retângulo usado para rotular, caixa ou separar outro controles. Os controles estáticos não tomar nenhuma entrada e não fornecem nenhuma saída. Para obter mais informações sobre controles estáticos e os estilos você pode especificar in a dwStyle parâmetro, consulte Estilos de controle.

Embora o dwExStyle Não é WS_EX_CONTROLPARENT com suporte em Windows CE 5.0 e anteriores, ele é um exigido sinalizador para o Windows CE 5.0 com o Windows CE 5.0 Networked Media Device Feature Pack e posteriores ao usar CreateWindowEx. Construtor de Expressões plataforma pode gerar uma mensagem aviso que WS_EX_CONTROLPARENT não é com suporte, mas essa mensagem pode ser ignorado e é inofensiva.

Requirements

Header	winuser.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via

CreateWindowEx

Syntax

Parameters

Return Value

Remarks

Requirements

See Also

Reference

Recursos adicionais