CLinkCtrl::Create

Article
03/04/2013

Crée un contrôle de lien et l'attache à un objet d' 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 
);

Paramètres

lpszLinkMarkup
Pointeur vers une chaîne nulle terminée qui contient marqué en haut du texte à afficher.Pour plus d'informations, consultez la section « balisage et le lien Accès » dans la rubrique Vue d'ensemble des contrôles de SysLink dans MSDN Library.
dwStyle
Spécifie le style du contrôle de lien.Appliquez une combinaison des styles de contrôle.Consultez Styles de contrôles communs dans Windows SDK pour plus d'informations.
rect
Spécifie la taille et la position du contrôle de lien.Ce peut être un objet de CRect ou une structure de RECT .
pParentWnd
Spécifie la fenêtre parente du contrôle de lien.Ne doit pas être NULL.
nID
Spécifie l'ID du contrôle de lien

Valeur de retour

true si l'initialisation a abouti ; sinon false.

Notes

Vous construisez un objet d' CLinkCtrl en deux étapes.D'abord, appelez le constructeur puis appelez Create, qui crée le contrôle de lien et l'attache à l'objet d' CLinkCtrl .Si vous souhaitez utiliser des styles de fenêtre étendus avec votre contrôle, appelez CLinkCtrl::CreateEx au lieu d' Create.

La deuxième forme de la méthode d' Create est déconseillée.Utilisez le premier formulaire qui spécifie le paramètre d' lpszLinkMarkup .

Exemple

L'exemple de code suivant définit deux variables nommées, m_Link1 et m_Link2, qui sont utilisées pour accéder à deux contrôles de lien.

    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;

L'exemple de code suivant crée un contrôle de lien à partir de l'emplacement d'un autre contrôle de lien.Le chargeur de ressource crée le premier contrôle de lien lorsque votre application démarre.Lorsque votre application écrit la méthode pour OnInitDialog, vous créez un deuxième contrôle de lien par rapport à la position du premier contrôle de lien.Vous redimensionnez le deuxième contrôle de lien pour contenir le texte qu'il affiche.

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