haiku-website/static/legacy-docs/bebook/BMediaTheme_Overview.html

39 lines
7.2 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Be Book - System Overview - The Media Kit</title><link rel="stylesheet" href="be_book.css" type="text/css" media="all" /><link rel="shortcut icon" type="image/vnd.microsoft.icon" href="./images/favicon.ico" /><!--[if IE]>
<link rel="stylesheet" type="text/css" href="be_book_ie.css" />
<![endif]--><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><meta name="keywords" content="Access, BeOS, BeBook, API" /><link rel="start" href="index.html" title="The Be Book" /><link rel="up" href="TheMediaKit_Overview.html" title="The Media Kit" /><link rel="prev" href="BMediaRoster_Overview.html" title="BMediaRoster" /><link rel="next" href="BMediaTrack_Overview.html" title="BMediaTrack" /></head><body><div id="header"><div id="headerT"><div id="headerTL"><a accesskey="p" href="BMediaRoster_Overview.html" title="BMediaRoster"><img src="./images/navigation/prev.png" alt="Prev" /></a> <a accesskey="u" href="TheMediaKit_Overview.html" title="The Media Kit"><img src="./images/navigation/up.png" alt="Up" /></a> <a accesskey="n" href="BMediaTrack_Overview.html" title="BMediaTrack"><img src="./images/navigation/next.png" alt="Next" /></a></div><div id="headerTR"><div id="navigpeople"><a href="http://www.haiku-os.org"><img src="./images/People_24.png" alt="haiku-os.org" title="Visit The Haiku Website" /></a></div><div class="navighome" title="Home"><a accesskey="h" href="index.html"><img src="./images/navigation/home.png" alt="Home" /></a></div><div class="navigboxed" id="navigindex"><a accesskey="i" href="ClassIndex.html" title="Index">I</a></div><div class="navigboxed" id="naviglang" title="English">en</div></div><div id="headerTC">The Be Book - System Overview - The Media Kit</div></div><div id="headerB">Prev: <a href="BMediaRoster_Overview.html">BMediaRoster</a>  Up: <a href="TheMediaKit_Overview.html">The Media Kit</a>  Next: <a href="BMediaTrack_Overview.html">BMediaTrack</a></div><hr /></div><div class="section"><div xmlns="" xmlns:d="http://docbook.org/ns/docbook" class="titlepage"><div><div xmlns:d="http://docbook.org/ns/docbook"><h2 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="BMediaTheme_Overview"></a>BMediaTheme</h2></div></div></div><a id="id590114" class="indexterm"></a><p>A <a class="link" href="BMediaTheme.html" title="BMediaTheme"><code class="classname">BMediaTheme</code></a>
is an object that, given a
<a class="link" href="BParameterWeb.html" title="BParameterWeb"><code class="classname">BParameterWeb</code></a>, can create a
<a class="link" href="BView.html" title="BView"><code class="classname">BView</code></a>
containing all the controls needed to configure the
<a class="link" href="BControllable.html" title="BControllable"><code class="classname">BControllable</code></a>
node represented by the
<a class="link" href="BParameterWeb.html" title="BParameterWeb"><code class="classname">BParameterWeb</code></a>.
You can then add the returned
<a class="link" href="BView.html" title="BView"><code class="classname">BView</code></a>
to a window so the user can configure the node to their liking.</p><p>The resulting
<a class="link" href="BView.html" title="BView"><code class="classname">BView</code></a>
contains not only the controls for configuring the
parameters available in the node, but also indicates the data flow path
through the node.</p><p>The BeOS includes the standard theme, which provides the system default
look to media controls, as seen in the Audio and Video preference
applications beginning with Release 4.</p><p>If you want to change the look of media controls within the BeOS, you can
write your own
<a class="link" href="BMediaTheme.html" title="BMediaTheme"><code class="classname">BMediaTheme</code></a>
and install it as the default system theme by calling
<a class="link" href="BMediaTheme.html#BMediaTheme_SetPreferredTheme"><code class="methodname">SetPreferredTheme()</code></a>.
If you want to write a new theme and provide
the ability for the user to enable it as the new system theme, you'll
need to write an application that calls
<a class="link" href="BMediaTheme.html#BMediaTheme_SetPreferredTheme"><code class="methodname">SetPreferredTheme()</code></a>.</p><p>If you want to return to the default system theme, you should call
<span class="code"><code class="methodname">SetPreferredTheme</code>(<code class="constant">NULL</code>)</span>.
Make sure you don't have any theme views
instantiated in your application when you do so.</p><div class="section"><div xmlns="" xmlns:d="http://docbook.org/ns/docbook" class="titlepage"><div><hr /><div xmlns:d="http://docbook.org/ns/docbook"><h3 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="id590248"></a>Installing a Theme Add-on</h3></div></div></div><p>Theme add-ons belong at
<code class="filename">/boot/home/config/add-ons/media/themes</code>. They can
have any name you like.</p><div class="admonition warning"><div class="title">Warning</div><div class="graphic"><img class="icon" alt="Warning" width="32" src="./images/admonitions/Stop_32.png" /><div class="text"><p>At this time, theme add-on support has not been sufficiently tested and
may or may not work. If you have problems with it, please file a bug
report at http://bebugs.be.com.</p></div></div></div></div></div><div id="footer"><hr /><div id="footerT">Prev: <a href="BMediaRoster_Overview.html">BMediaRoster</a>  Up: <a href="TheMediaKit_Overview.html">The Media Kit</a>  Next: <a href="BMediaTrack_Overview.html">BMediaTrack</a> </div><div id="footerB"><div id="footerBL"><a href="BMediaRoster_Overview.html" title="BMediaRoster"><img src="./images/navigation/prev.png" alt="Prev" /></a> <a href="TheMediaKit_Overview.html" title="The Media Kit"><img src="./images/navigation/up.png" alt="Up" /></a> <a href="BMediaTrack_Overview.html" title="BMediaTrack"><img src="./images/navigation/next.png" alt="Next" /></a></div><div id="footerBR"><div><a href="http://www.haiku-os.org"><img src="./images/People_24.png" alt="haiku-os.org" title="Visit The Haiku Website" /></a></div><div class="navighome" title="Home"><a accesskey="h" href="index.html"><img src="./images/navigation/home.png" alt="Home" /></a></div></div><div id="footerBC"><a href="http://www.access-company.com/home.html" title="ACCESS Co."><img alt="Access Company" src="./images/access_logo.png" /></a></div></div></div><div id="licenseFooter"><div id="licenseFooterBL"><a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/" title="Creative Commons License"><img alt="Creative Commons License" style="border-width:0" src="https://licensebuttons.net/l/by-nc-nd/3.0/88x31.png" /></a></div><div id="licenseFooterBR"><a href="./LegalNotice.html">Legal Notice</a></div><div id="licenseFooterBC"><span id="licenseText">This work is licensed under a
<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative
Commons Attribution-Non commercial-No Derivative Works 3.0 License</a>.</span></div></div></body></html>