CLinkCtrl::Create

Статья
06/10/2015

Создает элемент управления ссылки и вложение его к объекту 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  
);

Параметры

lpszLinkMarkup
Указатель на нулевой- завершенной строке, содержащей признаком вверх текст для отображения. Дополнительные сведения см. в подразделе "разметка и свяжите доступ" в разделе Обзор элементов управления SysLink библиотека MSDN.
dwStyle
Задает стиль элемента управления ссылками. Примените все стили элемента управления. См. раздел Стили стандартных элементов управления в Windows SDK дополнительные сведения.
rect
Определяет размер и положение элемента управления ссылками. Может быть либо объектом CRect или структурой RECT.
pParentWnd
Задает родительское окно управление связями. Значение NULL недопустимо.
nID
Определяет идентификатор элемента управления связи

Возвращаемое значение

true если инициализация прошла успешно; в противном случае false.

Заметки

Построении объект CLinkCtrl в шагах 2. Во-первых, вызовите конструктор, и затем вызовите Create, который создает элемент управления ссылки и вложение его к объекту CLinkCtrl. Если необходимо использовать расширенные стили окна с элементом управления, вызовите CLinkCtrl::CreateEx вместо Create.

Вторая форма метода Create не рекомендуема. Используйте первую форму, которая указывает параметр lpszLinkMarkup.

Пример

В следующем примере кода определяется 2 именованной переменной m_Link1 и m_Link2, которые используются для доступа к 2 управления связи.

 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;

В следующем примере кода создается один элемент управления ссылками, основанное на месте другого элемента управления ссылками. Загрузчик ресурсов создает первый элемент управления связи когда запуске приложения. Когда приложение вставляет метод OnInitDialog создается второй элемент управления связи относительно позиции первого элемента управления ссылками. Затем измените размер второй элемент управления ссылки, приспособления текст, который он указывает.

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