CLinkCtrl::Create

Articolo
03/05/2013

Crea un controllo di collegamento e lo collega a un oggetto 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 
);

Parametri

lpszLinkMarkup
Puntatore a una stringa che termina con zero che contiene il testo rincarato da visualizzare.Per ulteriori informazioni, vedere la sezione "markup e collegare Accesso" nell'argomento Cenni preliminari sui controlli di SysLink in MSDN Library.
dwStyle
Specifica lo stile del controllo di collegamento.Applicare qualsiasi combinazione di stili del controllo.Vedere Stili di controlli comuni in Windows SDK per ulteriori informazioni.
rect
Specifica la dimensione e la posizione del controllo di collegamento.Può essere un oggetto CRect o una struttura RECT.
pParentWnd
Specifica la finestra padre del controllo di collegamento.Non deve essere NULL.
nID
Specifica l'id controllo di collegamento

Valore restituito

true se l'inizializzazione riuscita; in caso contrario false.

Note

Costruisce un oggetto CLinkCtrl in due passaggi.Innanzitutto, chiamare il costruttore e quindi chiamare Create, che crea il controllo collegamento e lo aggiunge all'oggetto CLinkCtrl.Se si desidera utilizzare gli stili estesi di windows con il controllo, chiamare CLinkCtrl::CreateEx anziché Create.

Il secondo formato del metodo Create è stato deprecato.Utilizzare il primo form che specifica il parametro lpszLinkMarkup.

Esempio

Nell'esempio di codice definisce due variabili, m_Link1 denominato e m_Link2, utilizzati per accedere a due controlli di collegamento.

    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;

Nell'esempio di codice viene creato un controllo di collegamento in base alla posizione di un altro controllo di collegamento.Il caricatore di risorse crea il primo controllo collegamento all'avvio.Quando l'applicazione accede al metodo di OnInitDialog, creare il secondo controllo collegamento relativo alla posizione del primo controllo di collegamento.Quindi si ridimensiona il secondo controllo collegamento per adattarsi al testo visualizzato.

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