diff options
Diffstat (limited to 'libcontextsubscriber/doc/html/migratingfromduivaluespace.html')
-rw-r--r-- | libcontextsubscriber/doc/html/migratingfromduivaluespace.html | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/libcontextsubscriber/doc/html/migratingfromduivaluespace.html b/libcontextsubscriber/doc/html/migratingfromduivaluespace.html new file mode 100644 index 00000000..28a357c2 --- /dev/null +++ b/libcontextsubscriber/doc/html/migratingfromduivaluespace.html @@ -0,0 +1,58 @@ +<!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>libcontextsubscriber: </title> +<link href="tabs.css" rel="stylesheet" type="text/css"/> +<link href="doxygen.css" rel="stylesheet" type="text/css"/> +</head> +<body> +<!-- Generated by Doxygen 1.6.1 --> +<div class="navigation" id="top"> + <div class="tabs"> + <ul> + <li><a href="index.html"><span>Main Page</span></a></li> + <li class="current"><a href="pages.html"><span>Related Pages</span></a></li> + <li><a href="namespaces.html"><span>Namespaces</span></a></li> + <li><a href="annotated.html"><span>Classes</span></a></li> + <li><a href="files.html"><span>Files</span></a></li> + </ul> + </div> +</div> +<div class="contents"> +<p>libcontextsubscriber is a replacement library for DuiValueSpace which is deprecated.</p> +<p>DuiValueSpace, the old subscription library providing the keys, is deprecated. This library is a replacement for it, providing better API and better implementation while maintaining the same core ideas and structure.</p> +<h2><a class="anchor" id="quicklook"> +A quick look</a></h2> +<p>The following code for creating a handle for a context property:</p> +<div class="fragment"><pre class="fragment"> DuiValueSpaceItem topEdge(<span class="stringliteral">"Context.Screen.TopEdge"</span>); + QObject::connect(&topEdge, SIGNAL(valueChanged()), + <span class="keyword">this</span>, SLOT(topEdgeChanged())); +</pre></div><p>becomes:</p> +<div class="fragment"><pre class="fragment"> <a class="code" href="class_context_property.html" title="The ContextProperty class allows access to keys and their values.">ContextProperty</a> topEdge(<span class="stringliteral">"Screen.TopEdge"</span>); + QObject::connect(&topEdge, SIGNAL(valueChanged()), + <span class="keyword">this</span>, SLOT(topEdgeChanged())); +</pre></div><p>The following code for listing the available context keys:</p> +<div class="fragment"><pre class="fragment"> DuiValueSpaceItem::listKeys(); +</pre></div><p>becomes:</p> +<div class="fragment"><pre class="fragment"> <a class="code" href="class_context_registry_info.html#a93a34519ddb495338876ba0e1d1a4247" title="Returns the singleton instance of the ContextRegistryInfo.">ContextRegistryInfo::instance</a>()-><a class="code" href="class_context_registry_info.html#a963309761292d39921da3fb06cb31060" title="Returns the list of all the keys currently availible in the registry.">listKeys</a>(); +</pre></div><h2><a class="anchor" id="prefix"> +The Context. prefix</a></h2> +<p>In <b>DuiValueSpace</b> and accompanying packages, the properties used to have a "Context." prefix. For example:</p> +<div class="fragment"><pre class="fragment"> Context.Screen.TopEdge + Context.Screen.IsCovered +</pre></div><p>This 'Context.' has been dropped now from <b>libcontextsubscriber</b> and all the provider packages. Providers now explicitly provide properties with keys like:</p> +<div class="fragment"><pre class="fragment"> Screen.TopEdge + Screen.IsCovered +</pre></div><p>For compatibility reasons the 'Context.' prefix is still supported in newer releases of <b>DuiValueSpace</b>. The <b>DuiValueSpace</b> library transparently adds the 'Context.' prefix to all access functions.</p> +<p>A call to:</p> +<div class="fragment"><pre class="fragment"> DuiValueSpaceItem topEdge(<span class="stringliteral">"Context.Screen.TopEdge"</span>); +</pre></div><p>...is internally in <b>DuiValueSpace</b> converted to actual <code>Screen.TopEdge</code> wire access. This mechanism has been introduced to make the <b>DuiValueSpace</b> and <b>libcontextsubscriber</b> libraries parallel-installable.</p> +<p>It's expected that all <b>DuiValueSpace</b> clients migrate to <b>libcontextsubscriber</b> eventually and <b>DuiValueSpace</b> library will be removed.</p> +<dl class="warning"><dt><b>Warning:</b></dt><dd>When migrating to <b>libcontextsubscriber</b> make sure to remove the 'Context.' from you key access paths. </dd></dl> +</div> +<hr size="1"/><address style="text-align: right;"><small>Generated on Fri Nov 27 10:23:11 2009 for libcontextsubscriber by +<a href="http://www.doxygen.org/index.html"> +<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address> +</body> +</html> |