CreateMDIWindow

A função CreateMDIWindow cria uma janela de filho de interface (MDI) documento várias.

 (HWND CreateMDIWindow LPTSTR  Boolean, / / ponteiro para registados o nome de classe filhoLPTSTRlpWindowName, / / ponteiro para nome da janelaDWORDdwStyle, / / estilo de janelaint X, / / horizontal posição da janela int Y, / / vertical posição da janela intnWidth, / / largura da janela intnHeight, / / altura da janelaHWNDhWndParent, / / identificador para janela pai (cliente MDI)HINSTANCEhInstance, / / identificador de instância de aplicativoLPARAMlParam / / aplicativo-definidos valor);
 

Parâmetros

boolean
Ponteiro para uma seqüência de caracteres null-terminated especificando a classe de janela da janela filho MDI. O nome de classe deve ter sido registrado por uma chamada para a função de RegisterClassEx.
lpWindowName
Ponteiro para uma seqüência de caracteres null-terminated que representa o nome da janela. O sistema exibe o nome na barra de título da janela filho.
dwStyle
Especifica o estilo de janela de filho MDI. Se a janela do cliente MDI é criada com o estilo de janela MDIS_ALLCHILDSTYLES, este parâmetro pode ser qualquer combinação dos estilos de janela listados na descrição de CreateWindow função. Caso contrário, este parâmetro pode ser um ou mais dos seguintes valores:
Valor Significado
WS_MINIMIZE Cria uma janela de filho MDI que inicialmente é minimizada.
WS_MAXIMIZE Cria uma janela de filho MDI que inicialmente estiver maximizada.
WS_HSCROLL Cria uma janela de filho MDI que tenha um barra de rolagem horizontal.
WS_VSCROLL Cria uma janela de filho MDI que tenha um barra de rolagem vertical.

X
Especifica a posição horizontal inicial, no cliente coordenadas da janela de filho MDI. Se este parâmetro é CW_USEDEFAULT, a janela filho MDI é atribuída a posição horizontal do padrão.
Y
Especifica a posição vertical inicial, no cliente coordenadas da janela de filho MDI. Se este parâmetro é CW_USEDEFAULT, a janela filho MDI é atribuída à posição vertical padrão.
nWidth
Especifica a largura inicial, em unidades dispositivo, da janela de filho MDI. Se este parâmetro é CW_USEDEFAULT, a janela filho MDI é atribuída a largura padrão.
nHeight
Especifica a altura inicial, em unidades dispositivo, da janela de filho MDI. Se este parâmetro for definido para CW_USEDEFAULT, a janela filho MDI é atribuída a altura padrão.
hWndParent
Identificador para a janela do cliente MDI que será o pai da janela de filho MDI novo.
hInstance
Identificador para a instância do aplicativo criando janela de filho MDI.
lParam
Especifica um valor definido pela aplicação.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador para a janela criada.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

Usando a função CreateMDIWindow é semelhante ao envio de mensagem WM_MDICREATE para uma janela do cliente MDI, exceto que a função pode criar uma janela filho MDI em um thread diferente, enquanto a mensagem não pode.

Windows 95:O sistema pode oferecer suporte a um máximo de 16.364 identificadores de janela.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de Interface de documentos múltiplos, funções de Interface de documentos múltiplos, CreateWindow, RegisterClassEx, WM_MDICREATE

Index