Compartir a través de


CLinkCtrl::Create

Crea un control de vínculos y lo asocia a un 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
    Puntero a una cadena cero- cancelada que contiene marcado encima del texto para mostrar. Para obtener más información, vea la sección “Marcado y vincule Access” en el tema Información general de los Controles de SysLink en MSDN Library.

  • dwStyle
    Especifica el estilo del control de vínculos. Aplica cualquier combinación de estilos del control. Vea Estilos de controles comunes en Windows SDK para obtener más información.

  • rect
    Especifica el tamaño y la posición del control de vínculos. puede ser un objeto de CRect o una estructura de RECT .

  • pParentWnd
    Especifica la ventana principal del control de vínculos. No debe ser NULL.

  • nID
    Especifica el identificador de control de vínculos

Valor devuelto

true si la inicialización se realizó correctamente; si no false.

Comentarios

Se crea un objeto de CLinkCtrl en dos pasos. Primero, llame al constructor y llame a Create, que hace que el control de vínculos y lo asocia al objeto de CLinkCtrl . Si desea utilizar estilos extendidos de las ventanas con su control, llame a CLinkCtrl::CreateEx en lugar de Create.

El segundo formulario de método de Create está desusada. Utilice el primer formulario que especifica el parámetro de lpszLinkMarkup .

Ejemplo

El ejemplo de código siguiente define dos variables, denominadas m_Link1 y m_Link2, que se utilizan para tener acceso a dos controles de vínculo.

    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;

El ejemplo de código siguiente crea un control de vínculos basada en la ubicación de otro control de vínculos. El cargador de recursos crea el primer control de vínculo cuando se inicia la aplicación. Cuando la aplicación especifica el método de OnInitDialog, cree el segundo control de vínculo respecto a la posición del primer control de vínculos. Se cambia el tamaño del segundo control de vínculo para ajustarse el texto que muestra.

  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));
    }

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

CLinkCtrl Class

Gráfico de jerarquías

CLinkCtrl::CreateEx