CLinkCtrl::Create

Artigo
02/25/2013

Cria um controle de link e anexá-la a um objeto de CLinkCtrl .

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 cadeia de caracteres zero finalizada que contém marcado acima de texto para exibir.Para obter mais informações, consulte a seção “marcação e vincular acesso” no tópico visão geral de controles de SysLink Biblioteca MSDNno.
dwStyle
Especifica o estilo de controle de link.Aplique qualquer combinação de estilos de controle.Consulte Estilos de controle comum em Windows SDK para mais informações.
rect
Especifica o tamanho e a posição de controle de link.Pode ser um objeto de CRect ou uma estrutura de RECT .
pParentWnd
Especifica a janela pai de controle de link.Não deve ser NULL.
nID
Especifica a identificação de controle de link

Valor de retorno

true se a inicialização tenha êxito; se não false.

Comentários

Você constrói um objeto de CLinkCtrl em duas etapas.Primeiro, o construtor e então chame Create, que cria o controle do link e anexa ao objeto de CLinkCtrl .Se você desejar usar estilos estendidos do windows com o controle, chame CLinkCtrl::CreateEx em vez de Create.

O segundo formulário do método de Create é substituído.Use o primeiro formulário que especifica o parâmetro de lpszLinkMarkup .

Exemplo

O exemplo de código a seguir define duas variáveis, m_Link1 chamado 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 na localização de outro controle de link.O carregador de recurso criar o primeiro controle de link quando seu aplicativo é iniciado.Quando seu aplicativo inserir o método de OnInitDialog, você cria o segundo controle de link relacionado a posição do primeiro controle de link.Em seguida você redimensiona o segundo controle de link para ajustar o texto que 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));
    }