<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Wt: Wt::WAnchor Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Wt
 <span id="projectnumber">3.2.3</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.5.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceWt.html">Wt</a> </li>
<li class="navelem"><a class="el" href="classWt_1_1WAnchor.html">WAnchor</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> </div>
<div class="headertitle">
<div class="title">Wt::WAnchor Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="Wt::WAnchor" --><!-- doxytag: inherits="Wt::WContainerWidget" -->
<p>A widget that represents an HTML anchor (to link to other documents).
<a href="classWt_1_1WAnchor.html#details">More...</a></p>
<p><code>#include <Wt/WAnchor></code></p>
<div class="dynheader">
Inheritance diagram for Wt::WAnchor:</div>
<div class="dyncontent">
<div class="center"><img src="classWt_1_1WAnchor__inherit__graph.png" border="0" usemap="#Wt_1_1WAnchor_inherit__map" alt="Inheritance graph"/></div>
<map name="Wt_1_1WAnchor_inherit__map" id="Wt_1_1WAnchor_inherit__map">
<area shape="rect" href="classWt_1_1WContainerWidget.html" title="A widget that holds and manages child widgets." alt="" coords="5,304,160,331"/><area shape="rect" href="classWt_1_1WInteractWidget.html" title="An abstract widget that can receive user-interface interaction." alt="" coords="11,229,155,256"/><area shape="rect" href="classWt_1_1WWebWidget.html" title="A base class for widgets with an HTML counterpart." alt="" coords="19,155,147,181"/><area shape="rect" href="classWt_1_1WWidget.html" title="The abstract base class for a user-interface component." alt="" coords="33,80,132,107"/><area shape="rect" href="classWt_1_1WObject.html" title="A base class for objects that participate in the signal/slot system." alt="" coords="35,5,131,32"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classWt_1_1WAnchor-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0416606719711d768ba21ceacc5bf496"></a><!-- doxytag: member="Wt::WAnchor::WAnchor" ref="a0416606719711d768ba21ceacc5bf496" args="(WContainerWidget *parent=0)" -->
 </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a0416606719711d768ba21ceacc5bf496">WAnchor</a> (<a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> *parent=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates an anchor. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a5b1d32b8c090696c78469cff012f667b">WAnchor</a> (const <a class="el" href="classWt_1_1WLink.html">WLink</a> &link, <a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> *parent=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates an anchor for the given link. <a href="#a5b1d32b8c090696c78469cff012f667b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a503e3ea62a0c6a79c913806514de8459">WAnchor</a> (const <a class="el" href="classWt_1_1WLink.html">WLink</a> &link, const <a class="el" href="classWt_1_1WString.html">WString</a> &text, <a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> *parent=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates an anchor for the given link with a text. <a href="#a503e3ea62a0c6a79c913806514de8459"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#ab9482c14a58b0412964c6668593a57ad">WAnchor</a> (const <a class="el" href="classWt_1_1WLink.html">WLink</a> &link, <a class="el" href="classWt_1_1WImage.html">WImage</a> *image, <a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> *parent=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates an anchor for the given link with an image. <a href="#ab9482c14a58b0412964c6668593a57ad"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8">setLink</a> (const <a class="el" href="classWt_1_1WLink.html">WLink</a> &link)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the link. <a href="#a90d1aa41c061bdc9e61fa42eb36b27d8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classWt_1_1WLink.html">WLink</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a2968895e024b0613027056e6d89e3d2f">link</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the link. <a href="#a2968895e024b0613027056e6d89e3d2f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#acf0206a2ac91ea67d68ba10e3a951ba3">setRef</a> (const std::string &url)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the linked URL (<b>deprecated</b>). <a href="#acf0206a2ac91ea67d68ba10e3a951ba3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#ae3ea26646f135bf133871564f5d6798d">setRefInternalPath</a> (const std::string &path)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets a link to an internal path (<b>deprecated</b>). <a href="#ae3ea26646f135bf133871564f5d6798d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">std::string & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#af2ff217a9dcf97c4c8699bbd218e3ad7">ref</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the destination URL or internal path (<b>deprecated</b>). <a href="#af2ff217a9dcf97c4c8699bbd218e3ad7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#af4b130e223525c4b6084eb2fb8797738">setResource</a> (<a class="el" href="classWt_1_1WResource.html">WResource</a> *resource)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets a destination resource (<b>deprecated</b>). <a href="#af4b130e223525c4b6084eb2fb8797738"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1WResource.html">WResource</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#ae95cf2ea27a8b04e74334e0e78e46bad">resource</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the destination resource (<b>deprecated</b>). <a href="#ae95cf2ea27a8b04e74334e0e78e46bad"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a8379cfef23023ac070d2b7dcedacdac8">setText</a> (const <a class="el" href="classWt_1_1WString.html">WString</a> &text)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the label text. <a href="#a8379cfef23023ac070d2b7dcedacdac8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classWt_1_1WString.html">WString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#aa29b29327d79b2e15ac74904e8b79cac">text</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the label text. <a href="#aa29b29327d79b2e15ac74904e8b79cac"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#abe96ca40734d6af4a901d5fb2a9c8c59">setWordWrap</a> (bool wordWrap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Configures text word wrapping. <a href="#abe96ca40734d6af4a901d5fb2a9c8c59"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a3a1e81695c7e7ddbb982e551d8305281">setTextFormat</a> (<a class="el" href="namespaceWt.html#a140dea437d52d3d7c438ea3bd16a1480">TextFormat</a> format)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Configures the text format. <a href="#a3a1e81695c7e7ddbb982e551d8305281"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="namespaceWt.html#a140dea437d52d3d7c438ea3bd16a1480">TextFormat</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a0831383a3707bf4f2e90e0c9d290dc8d">textFormat</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the text format. <a href="#a0831383a3707bf4f2e90e0c9d290dc8d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#af31ca59038f6b696b90c79fc1232ea64">wordWrap</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the widget may break lines. <a href="#af31ca59038f6b696b90c79fc1232ea64"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#ad9fc10558d724684b1fd9314aa5ea8e7">setImage</a> (<a class="el" href="classWt_1_1WImage.html">WImage</a> *image)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets an image. <a href="#ad9fc10558d724684b1fd9314aa5ea8e7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1WImage.html">WImage</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a144d76630a616ea8fb7b268240c6f7ff">image</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the image. <a href="#a144d76630a616ea8fb7b268240c6f7ff"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a169c32b60dcb5d4511a3cbdd4979c941">setTarget</a> (<a class="el" href="namespaceWt.html#a6c93a6e97016801a310275457e43f333">AnchorTarget</a> target)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the location where the linked content should be displayed. <a href="#a169c32b60dcb5d4511a3cbdd4979c941"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="namespaceWt.html#a6c93a6e97016801a310275457e43f333">AnchorTarget</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a75c557c92118cf0cdaaad437f8d91ad5">target</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the location where the linked content should be displayed. <a href="#a75c557c92118cf0cdaaad437f8d91ad5"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WAnchor.html#a188c6f7fa64408e9214c08292974834d">enableAjax</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Progresses to an Ajax-enabled widget. <a href="#a188c6f7fa64408e9214c08292974834d"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>A widget that represents an HTML anchor (to link to other documents). </p>
<p>Use an anchor to link to another web page, document, internal application path or a resource (which specifies application-dependent content that may be generated by your application on demand). The anchor may contain a label text, an image, or any other widget (as it inherits from <a class="el" href="classWt_1_1WContainerWidget.html" title="A widget that holds and manages child widgets.">WContainerWidget</a>). If you link to a document or external url, and do not want the application to terminate when the user follows the anchor, you must use <a class="el" href="classWt_1_1WAnchor.html#a169c32b60dcb5d4511a3cbdd4979c941">setTarget(TargetNewWindow)</a>. Even for non-HTML documents, this may be important since pending Ajax requests are cancelled if documents are not served within the browser window in certain browsers.</p>
<p>When linking to a <code>resource</code>, the anchor does not assume ownership of <code>resource</code>, so that you may share the same resources for several anchors.</p>
<p>Usage example: </p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classWt_1_1WAnchor.html#a0416606719711d768ba21ceacc5bf496" title="Creates an anchor.">WAnchor</a> *a;
<span class="comment">// Create an anchor that links to a URL</span>
a = <span class="keyword">new</span> <a class="code" href="classWt_1_1WAnchor.html#a0416606719711d768ba21ceacc5bf496" title="Creates an anchor.">WAnchor</a>(<span class="stringliteral">"http://www.webtoolkit.eu/"</span>, <span class="stringliteral">"Wt web toolkit"</span>, <span class="keyword">this</span>);
<span class="comment">// Create an anchor that links to an internal path</span>
a = <span class="keyword">new</span> <a class="code" href="classWt_1_1WAnchor.html#a0416606719711d768ba21ceacc5bf496" title="Creates an anchor.">WAnchor</a>(WLink(<a class="code" href="classWt_1_1WLink.html#a3e379080ffa1697b53ea31c121af702aa0d930c0019166af5d14caddac9e2cbed" title="An internal path.">WLink::InternalPath</a>, <span class="stringliteral">"/docs/"</span> + myDocName()), <span class="stringliteral">"Doc"</span>, <span class="keyword">this</span>);
<span class="comment">// and listen to the corresponding change in internal path</span>
<a class="code" href="classWt_1_1WApplication.html#a38d922da0a0d83395519f3eaab85d0f6" title="Returns the current application instance.">WApplication::instance</a>()->internalPathChanged().connect(<span class="keyword">this</span>, &DocsListWidget::onInternalPathChange);
<span class="comment">// Create an anchor that links to a resource</span>
WResource *r = <span class="keyword">new</span> PdfResource(<span class="keyword">this</span>); <span class="comment">// serializes to a PDF file.</span>
a = <span class="keyword">new</span> <a class="code" href="classWt_1_1WAnchor.html#a0416606719711d768ba21ceacc5bf496" title="Creates an anchor.">WAnchor</a>(r, <span class="stringliteral">"PDF version"</span>, <span class="keyword">this</span>);
a->setTarget(<a class="code" href="namespaceWt.html#a6c93a6e97016801a310275457e43f333a95e5b4e8a2eed99252fc0eb2bb483cd8" title="Show in a separate new tab or window.">TargetNewWindow</a>);
</pre></div><p>WAnchor is an <a class="el" href="classWt_1_1WWidget.html#ac78e3af143883334c82031790c87416e">inline </a> widget.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>If you set a text or image using one of the API methods like <a class="el" href="classWt_1_1WAnchor.html#a8379cfef23023ac070d2b7dcedacdac8" title="Sets the label text.">setText()</a> or <a class="el" href="classWt_1_1WAnchor.html#ad9fc10558d724684b1fd9314aa5ea8e7" title="Sets an image.">setImage()</a> or a constructor, you should not attempt to remove all contents (using <a class="el" href="classWt_1_1WContainerWidget.html#a608f748cbdda763f1a11556ddad9fbe1" title="Removes and deletes all child widgets.">clear()</a>, or provide a layout (using <a class="el" href="classWt_1_1WContainerWidget.html#a1c84e0ffe330d4798f0ce217f75be08c" title="Sets a layout manager for the container.">setLayout()</a>), as this will result in undefined behaviour: the text or image are simply inserted as widgets into the container.</dd></dl>
<h3>CSS</h3>
<p>The widget corresponds to the HTML <code><a></code> tag and does not provide styling. It can be styled using inline or external CSS as appropriate. </p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a5b1d32b8c090696c78469cff012f667b"></a><!-- doxytag: member="Wt::WAnchor::WAnchor" ref="a5b1d32b8c090696c78469cff012f667b" args="(const WLink &link, WContainerWidget *parent=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WAnchor::WAnchor </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WLink.html">WLink</a> & </td>
<td class="paramname"><em>link</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates an anchor for the given link. </p>
<p>The <code>link</code> may point to a URL, a dynamic resource, or an internal path.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8" title="Sets the link.">setLink()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a503e3ea62a0c6a79c913806514de8459"></a><!-- doxytag: member="Wt::WAnchor::WAnchor" ref="a503e3ea62a0c6a79c913806514de8459" args="(const WLink &link, const WString &text, WContainerWidget *parent=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WAnchor::WAnchor </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WLink.html">WLink</a> & </td>
<td class="paramname"><em>link</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classWt_1_1WString.html">WString</a> & </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates an anchor for the given link with a text. </p>
<p>The <code>link</code> may point to a URL, a dynamic resource, or an internal path.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8" title="Sets the link.">setLink()</a>, <a class="el" href="classWt_1_1WAnchor.html#a8379cfef23023ac070d2b7dcedacdac8" title="Sets the label text.">setText()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ab9482c14a58b0412964c6668593a57ad"></a><!-- doxytag: member="Wt::WAnchor::WAnchor" ref="ab9482c14a58b0412964c6668593a57ad" args="(const WLink &link, WImage *image, WContainerWidget *parent=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WAnchor::WAnchor </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WLink.html">WLink</a> & </td>
<td class="paramname"><em>link</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WImage.html">WImage</a> * </td>
<td class="paramname"><em>image</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates an anchor for the given link with an image. </p>
<p>Ownership of the image is transferred to the anchor.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8" title="Sets the link.">setLink()</a>, <a class="el" href="classWt_1_1WAnchor.html#ad9fc10558d724684b1fd9314aa5ea8e7" title="Sets an image.">setImage()</a> </dd></dl>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a188c6f7fa64408e9214c08292974834d"></a><!-- doxytag: member="Wt::WAnchor::enableAjax" ref="a188c6f7fa64408e9214c08292974834d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::enableAjax </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Progresses to an Ajax-enabled widget. </p>
<p>This method is called when the progressive bootstrap method is used, and support for AJAX has been detected. The default behavior will upgrade the widget's event handling to use AJAX instead of full page reloads, and propagate the call to its children.</p>
<p>You may want to reimplement this method if you want to make changes to widget when AJAX is enabled. You should always call the base implementation.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#a78016406c4746c56b2c2ffce7c5e181f" title="Progresses to an Ajax-enabled user interface.">WApplication::enableAjax()</a> </dd></dl>
<p>Reimplemented from <a class="el" href="classWt_1_1WWebWidget.html#a8e1d7c93f533be68e3d4ee34f65486fd">Wt::WWebWidget</a>.</p>
</div>
</div>
<a class="anchor" id="a144d76630a616ea8fb7b268240c6f7ff"></a><!-- doxytag: member="Wt::WAnchor::image" ref="a144d76630a616ea8fb7b268240c6f7ff" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WImage.html">WImage</a>* Wt::WAnchor::image </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the image. </p>
<p>Returns <code>0</code> if no image is set.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#ad9fc10558d724684b1fd9314aa5ea8e7" title="Sets an image.">setImage()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a2968895e024b0613027056e6d89e3d2f"></a><!-- doxytag: member="Wt::WAnchor::link" ref="a2968895e024b0613027056e6d89e3d2f" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classWt_1_1WLink.html">WLink</a>& Wt::WAnchor::link </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the link. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8" title="Sets the link.">setLink()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="af2ff217a9dcf97c4c8699bbd218e3ad7"></a><!-- doxytag: member="Wt::WAnchor::ref" ref="af2ff217a9dcf97c4c8699bbd218e3ad7" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string& Wt::WAnchor::ref </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the destination URL or internal path (<b>deprecated</b>). </p>
<p>When the anchor links to a resource, the current resource URL is returned. When the anchor links to an internal path, the internal path is returned. Otherwise, the linked URL is returned.</p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000012">Deprecated:</a></b></dt><dd>Use <a class="el" href="classWt_1_1WAnchor.html#a2968895e024b0613027056e6d89e3d2f" title="Returns the link.">link()</a> instead. </dd></dl>
</div>
</div>
<a class="anchor" id="ae95cf2ea27a8b04e74334e0e78e46bad"></a><!-- doxytag: member="Wt::WAnchor::resource" ref="ae95cf2ea27a8b04e74334e0e78e46bad" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WResource.html">WResource</a>* Wt::WAnchor::resource </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the destination resource (<b>deprecated</b>). </p>
<p>Returns <code>0</code> if no resource has been set.</p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000014">Deprecated:</a></b></dt><dd>Use <a class="el" href="classWt_1_1WAnchor.html#a2968895e024b0613027056e6d89e3d2f" title="Returns the link.">link()</a> instead. </dd></dl>
</div>
</div>
<a class="anchor" id="ad9fc10558d724684b1fd9314aa5ea8e7"></a><!-- doxytag: member="Wt::WAnchor::setImage" ref="ad9fc10558d724684b1fd9314aa5ea8e7" args="(WImage *image)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setImage </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WImage.html">WImage</a> * </td>
<td class="paramname"><em>image</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets an image. </p>
<p>If an image was previously set, it is deleted. The <code>image</code> is added using <a class="el" href="classWt_1_1WContainerWidget.html#a2cfe66d9b62940f889e99538a9f478d2" title="Adds a child widget to this container.">addWidget()</a>.</p>
<p>Ownership of the image is transferred to the anchor. </p>
</div>
</div>
<a class="anchor" id="a90d1aa41c061bdc9e61fa42eb36b27d8"></a><!-- doxytag: member="Wt::WAnchor::setLink" ref="a90d1aa41c061bdc9e61fa42eb36b27d8" args="(const WLink &link)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setLink </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WLink.html">WLink</a> & </td>
<td class="paramname"><em>link</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the link. </p>
<p>The link may hold a URL, a resource, or an internal path.</p>
<p>When the link points to a <a class="el" href="classWt_1_1WLink.html#a3e379080ffa1697b53ea31c121af702aabbacc06e7eeea70826b5dc1ab8664147">resource</a>, the contents of the link may be generated by your application on demand.</p>
<p>When the link points to an <a class="el" href="classWt_1_1WLink.html#a3e379080ffa1697b53ea31c121af702aa0d930c0019166af5d14caddac9e2cbed">internal path</a>, activating the anchor will change the <a class="el" href="classWt_1_1WApplication.html#aab6320ecdd0e8e4026e9ef1aca710ca5">application's internal path</a> or open a new session with the given path as <a class="el" href="classWt_1_1WEnvironment.html#acb2ba1f1f88e9cd6b7a57a2e51518ec6">initial path</a>). This is the easiest way to let the application participate in browser history, and generate URLs that are bookmarkable and search engine friendly. </p>
</div>
</div>
<a class="anchor" id="acf0206a2ac91ea67d68ba10e3a951ba3"></a><!-- doxytag: member="Wt::WAnchor::setRef" ref="acf0206a2ac91ea67d68ba10e3a951ba3" args="(const std::string &url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setRef </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"><em>url</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the linked URL (<b>deprecated</b>). </p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000010">Deprecated:</a></b></dt><dd>Use <a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8" title="Sets the link.">setLink()</a> instead. </dd></dl>
</div>
</div>
<a class="anchor" id="ae3ea26646f135bf133871564f5d6798d"></a><!-- doxytag: member="Wt::WAnchor::setRefInternalPath" ref="ae3ea26646f135bf133871564f5d6798d" args="(const std::string &path)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setRefInternalPath </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"><em>path</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets a link to an internal path (<b>deprecated</b>). </p>
<dl class="note"><dt><b>Note:</b></dt><dd>the <code>path</code> should be UTF8 encoded (we may fix the API to use <a class="el" href="classWt_1_1WString.html" title="A value class which describes a locale-aware unicode string.">WString</a> in the future).</dd></dl>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000011">Deprecated:</a></b></dt><dd>Use <a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8" title="Sets the link.">setLink()</a> instead. </dd></dl>
</div>
</div>
<a class="anchor" id="af4b130e223525c4b6084eb2fb8797738"></a><!-- doxytag: member="Wt::WAnchor::setResource" ref="af4b130e223525c4b6084eb2fb8797738" args="(WResource *resource)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setResource </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WResource.html">WResource</a> * </td>
<td class="paramname"><em>resource</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets a destination resource (<b>deprecated</b>). </p>
<p>The anchor does not assume ownership of the resource.</p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000013">Deprecated:</a></b></dt><dd>Use <a class="el" href="classWt_1_1WAnchor.html#a90d1aa41c061bdc9e61fa42eb36b27d8" title="Sets the link.">setLink()</a> instead. </dd></dl>
</div>
</div>
<a class="anchor" id="a169c32b60dcb5d4511a3cbdd4979c941"></a><!-- doxytag: member="Wt::WAnchor::setTarget" ref="a169c32b60dcb5d4511a3cbdd4979c941" args="(AnchorTarget target)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setTarget </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceWt.html#a6c93a6e97016801a310275457e43f333">AnchorTarget</a> </td>
<td class="paramname"><em>target</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the location where the linked content should be displayed. </p>
<p>By default, the linked content is displayed in the application (<a class="el" href="namespaceWt.html#a6c93a6e97016801a310275457e43f333ae976883723836b4423d81ecf590bde0c" title="Show Instead of the application.">Wt::TargetSelf</a>). When the destination is an HTML document, the application is replaced with the new document. When the link is to a document that cannot be displayed in the browser, it is offered for download or opened using an external program, depending on browser settings.</p>
<p>By setting <code>target</code> to <a class="el" href="namespaceWt.html#a6c93a6e97016801a310275457e43f333a95e5b4e8a2eed99252fc0eb2bb483cd8" title="Show in a separate new tab or window.">Wt::TargetNewWindow</a>, the destination is displayed in a new browser window or tab.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a75c557c92118cf0cdaaad437f8d91ad5" title="Returns the location where the linked content should be displayed.">target()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a8379cfef23023ac070d2b7dcedacdac8"></a><!-- doxytag: member="Wt::WAnchor::setText" ref="a8379cfef23023ac070d2b7dcedacdac8" args="(const WString &text)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setText </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WString.html">WString</a> & </td>
<td class="paramname"><em>text</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the label text. </p>
<p>If no text was previously set, a new <a class="el" href="classWt_1_1WText.html" title="A widget that renders (XHTML) text.">WText</a> widget is added using <a class="el" href="classWt_1_1WContainerWidget.html#a2cfe66d9b62940f889e99538a9f478d2" title="Adds a child widget to this container.">addWidget()</a>. </p>
</div>
</div>
<a class="anchor" id="a3a1e81695c7e7ddbb982e551d8305281"></a><!-- doxytag: member="Wt::WAnchor::setTextFormat" ref="a3a1e81695c7e7ddbb982e551d8305281" args="(TextFormat format)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setTextFormat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceWt.html#a140dea437d52d3d7c438ea3bd16a1480">TextFormat</a> </td>
<td class="paramname"><em>format</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Configures the text format. </p>
<p>The default text format is XHTMLText.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WText.html#af22c64c4c5fed3d2aef0915a7e5c5866" title="Sets the text format.">WText::setTextFormat()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="abe96ca40734d6af4a901d5fb2a9c8c59"></a><!-- doxytag: member="Wt::WAnchor::setWordWrap" ref="abe96ca40734d6af4a901d5fb2a9c8c59" args="(bool wordWrap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WAnchor::setWordWrap </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>wordWrap</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Configures text word wrapping. </p>
<p>When <code>wordWrap</code> is <code>true</code>, the text set with <a class="el" href="classWt_1_1WAnchor.html#a8379cfef23023ac070d2b7dcedacdac8" title="Sets the label text.">setText()</a> may be broken up over multiple lines. When <code>wordWrap</code> is <code>false</code>, the text will displayed on a single line, unless the text contains <code><br /></code> tags or other block-level tags.</p>
<p>The default value is <code>true</code>.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#af31ca59038f6b696b90c79fc1232ea64" title="Returns whether the widget may break lines.">wordWrap()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a75c557c92118cf0cdaaad437f8d91ad5"></a><!-- doxytag: member="Wt::WAnchor::target" ref="a75c557c92118cf0cdaaad437f8d91ad5" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceWt.html#a6c93a6e97016801a310275457e43f333">AnchorTarget</a> Wt::WAnchor::target </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the location where the linked content should be displayed. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a169c32b60dcb5d4511a3cbdd4979c941" title="Sets the location where the linked content should be displayed.">setTarget()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aa29b29327d79b2e15ac74904e8b79cac"></a><!-- doxytag: member="Wt::WAnchor::text" ref="aa29b29327d79b2e15ac74904e8b79cac" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classWt_1_1WString.html">WString</a> & Wt::WAnchor::text </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the label text. </p>
<p>Returns an empty string if no label was set.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a8379cfef23023ac070d2b7dcedacdac8" title="Sets the label text.">setText()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a0831383a3707bf4f2e90e0c9d290dc8d"></a><!-- doxytag: member="Wt::WAnchor::textFormat" ref="a0831383a3707bf4f2e90e0c9d290dc8d" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceWt.html#a140dea437d52d3d7c438ea3bd16a1480">TextFormat</a> Wt::WAnchor::textFormat </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the text format. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#a3a1e81695c7e7ddbb982e551d8305281" title="Configures the text format.">setTextFormat()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="af31ca59038f6b696b90c79fc1232ea64"></a><!-- doxytag: member="Wt::WAnchor::wordWrap" ref="af31ca59038f6b696b90c79fc1232ea64" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WAnchor::wordWrap </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the widget may break lines. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WAnchor.html#abe96ca40734d6af4a901d5fb2a9c8c59" title="Configures text word wrapping.">setWordWrap(bool)</a> </dd></dl>
</div>
</div>
</div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Enumerator</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr size="1"><address style="text-align: right; margin: 3px"><small>
Generated on Thu Nov 1 2012 for <a href="http://www.webtoolkit.eu/wt">the
C++ Web Toolkit (Wt)</a> by <a
href="http://www.doxygen.org/index.html"><img src="doxygen.png"
alt="doxygen" border="0" style="vertical-align: middle; display:
inline-block; height: 2em"></a> 1.7.5.1</small></address>
</body>
</html>
