Compartilhar via


CListBox::Create

Cria o caixa de listagem e anexar-las ao objeto de CListBox .

virtual BOOL Create( 
   DWORD dwStyle, 
   const RECT& rect, 
   CWnd* pParentWnd, 
   UINT nID  
);

Parâmetros

  • dwStyle
    Especifica o estilo da caixa de listagem. Aplique qualquer combinação de estilos da caixa de listagem a caixa.

  • rect
    Especifica o tamanho e a posição da caixa de listagem. Pode ser um objeto de CRect ou uma estrutura de RECT .

  • pParentWnd
    Especifica a janela pai da caixa de lista (geralmente um objeto de CDialog ). Não deve ser NULO.

  • nID
    Especifica a identificação do controle de caixa de lista

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Você constrói um objeto de CListBox em duas etapas. Primeiro, o construtor e então chame Criar, que inicializa o caixa de listagem e as anexar para o objeto de CListBox .

Quando Criar é executado, o envia mensagens de WM_NCCREATE, de WM_CREATE, de WM_NCCALCSIZE, e de WM_GETMINMAXINFO ao controle de caixa de listagem.

Essas mensagens são tratadas por padrão pelas funções de membro de OnNcCreate, de OnCreate, de OnNcCalcSize, e de OnGetMinMaxInfo na classe base de CWnd . Para estender tratamento de mensagem padrão, derive uma classe de CListBox, adicione um mapa de mensagem para a nova classe, e substituir as funções de membro anterior de mensagem- manipulador. Substitua OnCreate, por exemplo, para executar a inicialização necessário para uma nova classe.

Aplicar a seguir estilos de janela a um controle de caixa de listagem.

  • WS_CHILD sempre

  • WS_VISIBLE geralmente

  • WS_DISABLED raramente

  • WS_VSCROLL para adicionar uma barra de rolagem vertical

  • WS_HSCROLL para adicionar uma barra de rolagem horizontal

  • WS_GROUP para os controles de grupo

  • WS_TABSTOP para permitir catálogo a esse controle

Exemplo

// pParentWnd is a pointer to the parent window.
m_myListBox.Create(WS_CHILD|WS_VISIBLE|LBS_STANDARD|WS_HSCROLL, 
   CRect(10,10,200,200), pParentWnd, IDC_MYLISTBOX);

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CListBox

Gráfico da hierarquia

CListBox::CListBox