diff options
Diffstat (limited to 'libcontextsubscriber/doc/html/migratingfromduivaluespace.html')
| -rw-r--r-- | libcontextsubscriber/doc/html/migratingfromduivaluespace.html | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/libcontextsubscriber/doc/html/migratingfromduivaluespace.html b/libcontextsubscriber/doc/html/migratingfromduivaluespace.html new file mode 100644 index 00000000..ff8247f1 --- /dev/null +++ b/libcontextsubscriber/doc/html/migratingfromduivaluespace.html @@ -0,0 +1,60 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html><head><meta http-equiv="Content-Type" content="text/html;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.5.8 --> +<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"> +libcontextsubscriber is a replacement library for DuiValueSpace which is deprecated.<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.<h2><a class="anchor" name="quicklook"> +A quick look</a></h2> +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#93a34519ddb495338876ba0e1d1a4247" title="Returns the singleton instance of the ContextRegistryInfo.">ContextRegistryInfo::instance</a>()-><a class="code" href="class_context_registry_info.html#963309761292d39921da3fb06cb31060" title="Returns the list of all the keys currently availible in the registry.">listKeys</a>(); +</pre></div><h2><a class="anchor" name="prefix"> +The Context. prefix</a></h2> +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> +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> +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" compact><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 Tue Oct 20 09:32:32 2009 for libcontextsubscriber by +<a href="http://www.doxygen.org/index.html"> +<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address> +</body> +</html> |