{"id":57,"date":"2007-07-05T04:12:47","date_gmt":"2007-07-05T09:12:47","guid":{"rendered":"http:\/\/mariusbancila.ro\/blog\/?p=57"},"modified":"2013-08-13T10:06:45","modified_gmt":"2013-08-13T08:06:45","slug":"syslink-control-in-mfc-90","status":"publish","type":"post","link":"https:\/\/mariusbancila.ro\/blog\/2007\/07\/05\/syslink-control-in-mfc-90\/","title":{"rendered":"Syslink Control in MFC 9.0"},"content":{"rendered":"

Visual Studio 2008 (formely code-named ‘Orcas’) has several important updates for VC++ and MFC. Among them the possibility to create syslink\u00a0controls, command or split buttons and network address controls. In this post I will show how you can work with the syslink control. The control provides a way to embed hypertext links in a window. It is actually a window that renders marked-up text just as hyperlinks in a\u00a0web browser. Multiple links can be put in a single control, and are accessed by a zero-based index.<\/p>\n

Currently it supports the anchor tag (<A>) with the HREF and ID attributes. HREF is used to specify a URL of any protocol (http, ftp, mailto, etc.). On the other hand ID specifies an unique name within the control, associated with an individual link.<\/p>\n

The content is available in the toolbar, so you can simply drag and drop syslink controls onto you dialog template.<\/p>\n

\"Syslink<\/p>\n

You can specify the text, including the anchor tag from the properties page, or you can use the SetWindowText function to set it at run-time.<\/p>\n

\r\nGetDlgItem(IDC_SYSLINK1)->SetWindowText(\r\n   L\"Visit my <a href=\\\"http:\/\/www.mariusbancila.ro\\\">web site<\/a>\"\r\n   L\" and check my <a href=\\\"http:\/\/www.mariusbancila.ro\/blog\\\">blog<\/a>.\");\r\n<\/pre>\n
You have to handle the NM_CLICK notification, check which link was clicked and take the appropriate action:<\/p>\n
\r\nBEGIN_MESSAGE_MAP(CMFCDemoDlg, CDialog) \r\n\tON_NOTIFY(NM_CLICK, IDC_SYSLINK1, &CMFCDemoDlg::OnNMClickSyslink1) \r\nEND_MESSAGE_MAP()   \r\n\r\nvoid CMFCDemoDlg::OnNMClickSyslink1(NMHDR *pNMHDR, LRESULT *pResult) \r\n{ \r\n\tPNMLINK pNMLink = (PNMLINK) pNMHDR;   \r\n\r\n\tif (wcscmp(pNMLink->item.szUrl, WEB_SITE) == 0) \r\n\t{ \r\n\t\tShellExecuteW(NULL, L\"open\", pNMLink->item.szUrl, NULL, NULL, SW_SHOWNORMAL); \r\n\t} \r\n\telse if(wcscmp(pNMLink->item.szUrl, BLOG_LINK) == 0) \r\n\t{ \r\n\t\tShellExecuteW(NULL, L\"open\", pNMLink->item.szUrl, NULL, NULL, SW_SHOWNORMAL); \r\n\t}   \r\n\r\n\t*pResult = 0; \r\n}<\/pre>\n
In MFC 9.0 (version that will ship with Visual Studio 2008) class CLinkCtrl<\/tt> is a wrapper over the Windows API for working with the syslink control.<\/p>\n
You can associate an instance of CLinkCtrl<\/tt> with a syslink control through the DDX mechanism:<\/p>\n
\r\nvoid CMFCDemoDlg::DoDataExchange(CDataExchange* pDX) \r\n{ \r\n\tCDialog::DoDataExchange(pDX); \r\n\tDDX_Control(pDX, IDC_SYSLINK2, Link2); \r\n}<\/pre>\n
In my demo application that you can download from here<\/a> I used a second syslink with an ID attribute. Each time the link is clicked it increments a counter, which is shown. For that I created two helper functions first, one to generate part of the text and the second to set the text to the link control:<\/p>\n
\r\nCString CMFCDemoDlg::GetClickText() const \r\n{ \r\n\tCString str; \r\n\tstr.Format(L\"clicked %d times\", Clicks); \r\n\treturn str; \r\n}   \r\n\r\nvoid CMFCDemoDlg::SetLink2Text() \r\n{ \r\n\tLink2.SetWindowText(L\"Link was <a id=\"\\\">\" + GetClickText() + L\"<\/a>\"); \r\n}<\/pre>\n
When handling the NM_CLICK notification, I checked the szID member of structure LITEM and took the appropriate action:<\/p>\n
\r\nvoid CMFCDemoDlg::OnNMClickSyslink2(NMHDR *pNMHDR, LRESULT *pResult) \r\n{ \r\n\tPNMLINK pNMLink = (PNMLINK) pNMHDR;   \r\n\r\n\tif (wcscmp(pNMLink->item.szID, L\"clicked\") == 0) \r\n\t{ \r\n\t\tClicks++; \r\n\t\tSetLink2Text(); \r\n\t}   \r\n\r\n\t*pResult = 0; \r\n}<\/pre>\n
The result is shown here:<\/p>\n
\"Syslink<\/p>\n
Hopefully the sample code that I put together will help you work with CLinkCtrl<\/tt> and the syslink control in VS 2008.<\/p>\n","protected":false},"excerpt":{"rendered":"
Visual Studio 2008 (formely code-named ‘Orcas’) has several important updates for VC++ and MFC. Among them the possibility to create syslink\u00a0controls, command or split buttons and network address controls. In this post I will show how you can work with the syslink control. The control provides a way to embed hypertext links in a window. … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","advgb_blocks_editor_width":"","advgb_blocks_columns_visual_guide":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[12,8],"tags":[375,453,374,373,459],"class_list":["post-57","post","type-post","status-publish","format-standard","hentry","category-mfc","category-windows-programming","tag-clinkctrl","tag-mfc","tag-syslink","tag-vista","tag-windows"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t