CLinkCtrl::Create

Artykuł
02/27/2013

Tworzy łącze formant i dołączona do CLinkCtrl obiektu.

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

Parametry

lpszLinkMarkup
Wskaźnik, aby ciąg zakończony zerem, zawierający zaznaczone tekst do wyświetlenia.Aby uzyskać więcej informacji, zobacz sekcję "Adiustacji i łącze dostępu" w temacie Omówienie kontroli SysLink w MSDN Library.
dwStyle
Określa styl link control.Zastosuj dowolną kombinację stylów formantu.Zobacz Wspólnych stylów formantu w Windows SDK Aby uzyskać więcej informacji.
rect
Określa rozmiar i położenie link control.Mogą być albo CRect obiektu lub RECT struktury.
pParentWnd
Określa link control okno nadrzędne.Nie wolno NULL.
nID
Określa identyfikator formantu łącze.

Wartość zwracana

trueJeśli inicjalizacja zakończyła się pomyślnie; w przeciwnym razie false.

Uwagi

Można skonstruować CLinkCtrl obiektu w dwóch etapach.Po pierwsze, wywołanie konstruktora, a następnie wywołać Create, który tworzy link control i dołącza go do CLinkCtrl obiektu.Jeśli chcesz użyć stylów rozszerzonego systemu windows z formantu, wywołanie CLinkCtrl::CreateEx zamiast Create.

Druga forma Create metoda jest niezalecane.Użyj pierwszego formularza, który określa lpszLinkMarkup parametru.

Przykład

Poniższy kod definiuje dwie zmienne, o nazwie m_Link1 i m_Link2, używane do dostępu dwa formanty łącze.

    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;

Poniższy kod tworzy jeden formant łącza na podstawie lokalizacji innego formantu łącze.Moduł ładujący zasobu tworzy pierwszy formant łącza podczas uruchamiania aplikacji.Aplikacja wprowadza metodę OnInitDialog, tworzysz drugi formant łącza położeniu pierwszy formant łącza.Następnie zmień rozmiar drugiego formantu łącza do tekstu, który wyświetla.

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