CLinkCtrl::criar

Artigo
08/25/2010

Cria um controle de link e a anexa um CLinkCtrl objeto.

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

Parâmetros

lpszLinkMarkup
Ponteiro para uma seqüência de caracteres terminada em zero que contém o marcado de texto a ser exibido.Para obter mais informações, consulte a seção "Marcação e acesso de link" no tópicoVisão geral dos controles SysLink in the Biblioteca MSDN.
dwStyle
Especifica o estilo de controle de link.Aplique qualquer combinação de estilos de controle.See Estilos de controle comuns in the Windows SDK Para obter mais informações.
rect
Especifica o dimensionar e posição do controle de link.Pode ser qualquer um CRect objeto ou um RECT estrutura.
pParentWnd
Especifica a janela pai do controle de link.Não deve ser NULL.
nID
Especifica a ID. do controle de link

Valor de retorno

true Se a inicialização foi bem-sucedida; caso contrário false.

Comentários

Construir um CLinkCtrl objeto em duas etapas. Primeiro, telefonar construtor e, em seguida, telefonar Create, que cria o controle de link e anexa-o para o CLinkCtrl objeto. Se você quiser usar estilos estendidos janelas com seu controle, chamar CLinkCtrl::CreateEx em vez de Create.

O segundo formulário do Create método está obsoleto. Use o formulário primeiro Especifica o lpszLinkMarkup parâmetro.

Exemplo

O exemplo de código a seguir define duas variáveis, chamadas m_Link1 e m_Link2, que são usados para acessar dois controles de link.

   afx_msg void OnNMClickSyslink1(NMHDR *pNMHDR, LRESULT *pResult);
    afx_msg void OnNMClickSyslink2(NMHDR *pNMHDR, LRESULT *pResult);
    // Link variable associated with resource editor CLinkCtrl control.
    CLinkCtrl m_Link1;
    // Link variable associated with programmatic CLinkCtrl control.
    CLinkCtrl m_Link2;

O exemplo de código a seguir cria um controle de link com base no local de outro controle de link.O carregador de recursos cria o primeiro controle de link quando seu aplicativo é iniciado.Quando o método OnInitDialog entra em seu aplicativo, você cria o segundo controle de link em relação à posição do primeiro controle de link.Em seguida, você pode redimensionar o segundo controle de link para ajuste o texto que ele exibe.

    CRect rect1, rect2;
    int height = 0;
    SIZE sz = {0};
    PTCHAR url = 
        _T("Link 2)  ")
        _T("<A HREF=\"https://msdn2.microsoft.com/en-us/visualc/default.aspx\">")
        _T("Microsoft VC++ Home")
        _T("</A>");
    m_Link1.GetWindowRect( &rect1 );
    m_Link2.Create(url,
        (WS_VISIBLE | WS_TABSTOP | WS_CHILD | WS_BORDER),
        CRect(
        rect1.left, rect1.bottom + rect1.Height(), 
        rect1.right, rect1.bottom + (2*rect1.Height())),
        this,
        IDC_SYSLINK2);
    m_Link2.GetClientRect( &rect2 );
    // The return value of GetIdealSize() is the same as sz.cy
    height = m_Link2.GetIdealSize( 
        rect2.Width(), &sz);
    if ((sz.cx != 0) && (sz.cy != 0)) {
        int rc = m_Link2.SetWindowPos(
            this, 
            0, 0, sz.cx, sz.cy,
            (SWP_NOMOVE | SWP_NOZORDER | SWP_NOREPOSITION | SWP_NOACTIVATE));
    }