You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pivot.apache.org by sm...@apache.org on 2012/01/19 01:51:42 UTC
svn commit: r1233143 [12/47] - in /pivot/site/trunk/deploy: ./ 2.0.1/
2.0.1/docs/ 2.0.1/docs/api/ demos/ tutorials/
Modified: pivot/site/trunk/deploy/tutorials/checkboxes.html
URL: http://svn.apache.org/viewvc/pivot/site/trunk/deploy/tutorials/checkboxes.html?rev=1233143&r1=1233142&r2=1233143&view=diff
==============================================================================
--- pivot/site/trunk/deploy/tutorials/checkboxes.html (original)
+++ pivot/site/trunk/deploy/tutorials/checkboxes.html Thu Jan 19 00:51:39 2012
@@ -1,4 +1,4 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -14,137 +14,139 @@ distributed under the License is distrib
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
---><html xmlns="http://www.w3.org/1999/xhtml"><head><meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /><title>Checkboxes | Apache Pivot</title><link xmlns="" type="text/css" rel="stylesheet" href="/styles/pivot.css"><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript">
- var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
- document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
- </script><script type="text/javascript">
- try {
- var pageTracker = _gat._getTracker("UA-7977275-3");
- pageTracker._trackPageview();
- } catch(err) {}</script></head><body><div xmlns="" id="wrapper"><div id="main"><div id="header"><div class="logo"><a href="/index.html"><img title="Apache Pivot Homepage" alt="Apache Pivot" src="/images/logo.png"></a></div><div class="tagline"><img style="visibility:hidden" alt="Rich Internet Applications in Java" src="/images/tagline.png"></div><ul class="navi"><li><a href="/demos/">Demos</a></li><li><a href="/download.cgi#2.0">Download</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/get-involved.html">Get Involved</a></li><li><a href="/about.html">About</a></li></ul></div><div class="group" id="contentBase"><h1>Checkboxes</h1><ul class="naviLeft"><li><a href="/tutorials/sample-application.html">Sample Application</a></li><li><a href="/tutorials/platform-overview.html">Platform Overview</a></li><li><a href="/tutorials/hello-world.html">Hello, World!</a></li><li><a href="/tutorials/hello-bxml.html">Hello, BXML!</a></li><li><a href="/tutorials
/component-and-container.html">Component & Container</a></li><li><a href="/tutorials/labels-and-image-views.html">Labels & Image Views</a></li><li><a href="/tutorials/svg-images.html">SVG Images</a></li><li><a href="/tutorials/buttons.html">Buttons</a></li><li><a href="/tutorials/push-buttons.html">Push Buttons</a></li><li><a href="/tutorials/toggle-buttons.html">Toggle Buttons</a></li><li><a href="/tutorials/radio-buttons.html">Radio Buttons</a></li><li><a href="/tutorials/checkboxes.html">Checkboxes</a></li><li><a href="/tutorials/link-buttons.html">Link Buttons</a></li><li><a href="/tutorials/lists.html">Lists</a></li><li><a href="/tutorials/list-buttons.html">List Buttons</a></li><li><a href="/tutorials/repeatable-list-buttons.html">Repeatable List Buttons</a></li><li><a href="/tutorials/text.html">Text</a></li><li><a href="/tutorials/suggestion-popups.html">Suggestion Popups</a></li><li><a href="/tutorials/text-areas.html">Text Areas</a></li><li><a href="/tutori
als/separators.html">Separators</a></li><li><a href="/tutorials/layout-containers.html">Layout Containers</a></li><li><a href="/tutorials/flow-panes.html">Flow Panes</a></li><li><a href="/tutorials/box-panes.html">Box Panes</a></li><li><a href="/tutorials/grid-panes.html">Grid Panes</a></li><li><a href="/tutorials/table-panes.html">Table Panes</a></li><li><a href="/tutorials/borders.html">Borders</a></li><li><a href="/tutorials/stack-panes.html">Stack Panes</a></li><li><a href="/tutorials/split-panes.html">Split Panes</a></li><li><a href="/tutorials/forms.html">Forms</a></li><li><a href="/tutorials/panels.html">Panels</a></li><li><a href="/tutorials/navigation-containers.html">Navigation Containers</a></li><li><a href="/tutorials/card-panes.html">Card Panes</a></li><li><a href="/tutorials/tab-panes.html">Tab Panes</a></li><li><a href="/tutorials/accordions.html">Accordions</a></li><li><a href="/tutorials/expanders.html">Expanders</a></li><li><a href="/tutorials/rollups.html"
>Rollups</a></li><li><a href="/tutorials/viewports.html">Viewports</a></li><li><a href="/tutorials/scroll-panes.html">Scroll Panes</a></li><li><a href="/tutorials/panoramas.html">Panoramas</a></li><li><a href="/tutorials/progress-indicators.html">Progress Indicators</a></li><li><a href="/tutorials/meters.html">Meters</a></li><li><a href="/tutorials/activity-indicators.html">Activity Indicators</a></li><li><a href="/tutorials/bounded-range-components.html">Bounded Range Components</a></li><li><a href="/tutorials/sliders.html">Sliders</a></li><li><a href="/tutorials/scroll-bars.html">Scroll Bars</a></li><li><a href="/tutorials/spinners.html">Spinners</a></li><li><a href="/tutorials/calendars.html">Calendars</a></li><li><a href="/tutorials/menus.html">Menus</a></li><li><a href="/tutorials/context-menus.html">Context Menus</a></li><li><a href="/tutorials/menu-bars.html">Menu Bars</a></li><li><a href="/tutorials/menu-buttons.html">Menu Buttons</a></li><li><a href="/tutorials/colo
r-choosers.html">Color Choosers</a></li><li><a href="/tutorials/table-views.html">Table Views</a></li><li><a href="/tutorials/table-views.json.html">JSON-based TableView</a></li><li><a href="/tutorials/table-views.custom.html">Custom TableView</a></li><li><a href="/tutorials/tree-views.html">Tree Views</a></li><li><a href="/tutorials/file-browsing.html">File Browsing</a></li><li><a href="/tutorials/windows.html">Windows</a></li><li><a href="/tutorials/clipboard.html">Clipboard</a></li><li><a href="/tutorials/drag-and-drop.html">Drag and Drop</a></li><li><a href="/tutorials/effects.html">Effects</a></li><li><a href="/tutorials/effects.transitions.html">Transitions</a></li><li><a href="/tutorials/data-binding.html">Data Binding</a></li><li><a href="/tutorials/property-binding.html">Property Binding</a></li><li><a href="/tutorials/localization.html">Localization</a></li><li><a href="/tutorials/background-tasks.html">Background Tasks</a></li><li><a href="/tutorials/web-queries.h
tml">Web Queries</a></li><li><a href="/tutorials/query-servlet.html">QueryServlet</a></li><li><a href="/tutorials/scripting.html">Scripting</a></li><li><a href="/tutorials/summary.html">Summary</a></li><li><a href="/tutorials/stock-tracker.html">The "Stock Tracker" Application</a></li><li><a href="/tutorials/stock-tracker.ui.html">UI Markup Using BXML</a></li><li><a href="/tutorials/stock-tracker.events.html">Event Handling</a></li><li><a href="/tutorials/stock-tracker.web-queries.html">Web Queries</a></li><li><a href="/tutorials/stock-tracker.data-binding.html">Data Binding</a></li><li><a href="/tutorials/stock-tracker.localization.html">Localization</a></li><li><a href="/tutorials/bxml-primer.html">BXML Primer</a></li></ul><div class="content"><style type="text/css">
- applet {
- border: 1px solid #999999;
- }
- </style><!--NOTE: Syntax highlighting script is LGPL--><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shCore.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJava.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushXml.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJScript.js" type="text/javascript"></script><link href="http://alexgorbatchev.com/pub/sh/current/styles/shCore.css" rel="stylesheet" type="text/css"><link href="http://alexgorbatchev.com/pub/sh/current/styles/shThemeDefault.css" rel="stylesheet" type="text/css"><script type="text/javascript">
- SyntaxHighlighter.all();
- </script><div class="section">
- <p>
- The following example demonstrates how to use the <tt>Checkbox</tt> class in a Pivot
- application. Selecting a checkbox shows or hides an associated icon:
- </p>
-
- <script src="http://java.com/js/deployJava.js" type="text/javascript"></script><script type="text/javascript">
-
- var attributes = {
- code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
- width:"140",
- height:"100"
- };
-
-
-
-
-
- var libraries = [];
- libraries.push("/lib/pivot-core-2.0.jar");
- libraries.push("/lib/pivot-wtk-2.0.jar");
- libraries.push("/lib/pivot-wtk-terra-2.0.jar");
- libraries.push("/lib/pivot-tutorials-2.0.jar");
-
- libraries.push("/lib/svgSalamander-tiny.jar");
-
-
- attributes.archive = libraries.join(",");
-
-
- var parameters = {
- codebase_lookup:false,
- application_class_name:'org.apache.pivot.wtk.ScriptApplication'
- };
-
-
- var javaArguments = ["-Dsun.awt.noerasebackground=true",
- "-Dsun.awt.erasebackgroundonresize=true"];
-
-
-
- parameters.java_arguments = javaArguments.join(" ");
-
-
-
- var startupProperties = [];
-
- startupProperties.push("src=/org/apache/pivot/tutorials/buttons/checkboxes.bxml");
-
- parameters.startup_properties = startupProperties.join("&");
-
-
- deployJava.runApplet(attributes, parameters, "1.6");
- </script>
-
- <p>
- The BXML source for the example is below:
- </p>
-
- <pre class="brush:xml">
-
- <Window title="Checkboxes" maximized="true"
- xmlns:bxml="http://pivot.apache.org/bxml"
- xmlns="org.apache.pivot.wtk">
- <TablePane styles="{showHorizontalGridLines: true, showVerticalGridLines:true,
- padding:4, horizontalSpacing:1, verticalSpacing:1,
- horizontalGridColor:10, verticalGridColor:10}">
- <columns>
- <TablePane.Column width="-1"/>
- <TablePane.Column width="24"/>
- </columns>
-
- <TablePane.Row height="24">
- <BoxPane styles="{verticalAlignment:'center'}">
- <Checkbox buttonData="Bell"
- ButtonPressListener.buttonPressed="bellImageView.setVisible(!bellImageView.isVisible());"/>
- </BoxPane>
- <ImageView bxml:id="bellImageView" image="/org/apache/pivot/tutorials/bell.png" visible="false"/>
- </TablePane.Row>
-
- <TablePane.Row height="24">
- <BoxPane styles="{verticalAlignment:'center'}">
- <Checkbox buttonData="Clock"
- ButtonPressListener.buttonPressed="clockImageView.setVisible(!clockImageView.isVisible());"/>
- </BoxPane>
- <ImageView bxml:id="clockImageView" image="/org/apache/pivot/tutorials/clock.png" visible="false"/>
- </TablePane.Row>
-
- <TablePane.Row height="24">
- <BoxPane styles="{verticalAlignment:'center'}">
- <Checkbox buttonData="House"
- ButtonPressListener.buttonPressed="houseImageView.setVisible(!houseImageView.isVisible());"/>
- </BoxPane>
- <ImageView bxml:id="houseImageView" image="/org/apache/pivot/tutorials/house.png" visible="false"/>
- </TablePane.Row>
- </TablePane>
- </Window>
-
- </pre>
-
- <p>
- Note that this example uses the <tt>TablePane</tt> layout container. <tt>TablePane</tt>
- defines a two-dimensional grid structure and is similar to an HTML table. It is
- discussed in more detail in the <a href="layout-containers.html">Layout Containers</a>
- section.
- </p>
-
- <p>
- Also note the use of script code to respond to button press events fired by the
- checkboxes. The <tt>ButtonPressListener.buttonPressed</tt> attribute of each component
- contains JavaScript code that toggles the visibility of the corresponding image view,
- causing the image to appear and disappear based on the checkbox's selection state.
- It is common in Pivot development to implement simple event handlers in script code
- this way, since it can often be much less verbose than performing the same logic in Java.
- </p>
-
- <p>
- In fact, since all of the logic for this application is implemented in script, there
- is no Java source associated with this example.
- </p>
- </div><p>Next: <a href="link-buttons.html">Link Buttons</a></p></div></div></div><div class="group" id="footer"><div class="footerLogo">Copyright (c) 1999-2011<br>The Apache Software Foundation.</div><div class="footerLinks"><ul class="footerMenuGr"><li><strong>Demos</strong><ul><li><a href="/demos/kitchen-sink.html" target="_new">"Kitchen Sink"</a></li><li><a href="/demos/component-explorer.html" target="_new">Component Explorer</a></li><li><a href="http://ixnay.biz/pivot-jfree-demos/charts_demo.html" target="_new">Charting</a></li><li><a href="/demos/">More Demos</a></li></ul></li><li><strong>Documentation</strong><ul><li><a href="/getting-started.html">Getting Started</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/faq.html">FAQ</a></li><li><a href="/2.0/docs/api/">Javadoc (2.0)</a></li></ul></li><li><strong>Get Involved</strong><ul><li><a href="/svn.html">SVN Repositories</a></li><li><a href="/lists.html">Mailing Lists</a></li><li><a href="http://iss
ues.apache.org/jira/browse/PIVOT">Bug Database</a></li><li><a href="http://cwiki.apache.org/PIVOT/">Wiki</a></li></ul></li><li><strong>Related</strong><ul><li><a href="http://code.google.com/p/pivot-jfree/">JFreeChart Provider</a></li></ul></li><li><strong>About</strong><ul><li><a href="/who-we-are.html">Who We Are</a></li><li><a href="/contact.html">Contact</a></li><li><a href="/news.html">News</a></li><li><a href="/legal.html">Legal/License</a></li></ul></li></ul></div></div></div></body></html>
\ No newline at end of file
+--><html xmlns="http://www.w3.org/1999/xhtml"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Checkboxes | Apache Pivot</title><link href="/styles/pivot.css" rel="stylesheet" type="text/css"><script type="text/javascript">
+ var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+ document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+ </script><script type="text/javascript">
+ try {
+ var pageTracker = _gat._getTracker("UA-7977275-3");
+ pageTracker._trackPageview();
+ } catch(err) {}</script></head><body><div id="wrapper"><div id="main"><div id="header"><div xmlns="" class="logo"><a href="/index.html"><img src="/images/logo.png" alt="Apache Pivot" title="Apache Pivot Homepage"></a></div><div class="tagline"><img src="/images/tagline.png" alt="Rich Internet Applications in Java" style="visibility:hidden"></div><ul class="navi"><li><a href="/demos/">Demos</a></li><li><a href="/download.cgi#2.0.1">Download</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/get-involved.html">Get Involved</a></li><li><a href="/about.html">About</a></li></ul></div><div id="contentBase" class="group"><h1>Checkboxes</h1><ul class="naviLeft"><li><a href="/tutorials/sample-application.html">Sample Application</a></li><li><a href="/tutorials/platform-overview.html">Platform Overview</a></li><li><a href="/tutorials/hello-world.html">Hello, World!</a></li><li><a href="/tutorials/hello-bxml.html">Hello, BXML!</a></li><li><a href="/tutoria
ls/component-and-container.html">Component & Container</a></li><li><a href="/tutorials/labels-and-image-views.html">Labels & Image Views</a></li><li><a href="/tutorials/svg-images.html">SVG Images</a></li><li><a href="/tutorials/buttons.html">Buttons</a></li><li><a href="/tutorials/push-buttons.html">Push Buttons</a></li><li><a href="/tutorials/toggle-buttons.html">Toggle Buttons</a></li><li><a href="/tutorials/radio-buttons.html">Radio Buttons</a></li><li><a href="/tutorials/checkboxes.html">Checkboxes</a></li><li><a href="/tutorials/link-buttons.html">Link Buttons</a></li><li><a href="/tutorials/lists.html">Lists</a></li><li><a href="/tutorials/list-buttons.html">List Buttons</a></li><li><a href="/tutorials/repeatable-list-buttons.html">Repeatable List Buttons</a></li><li><a href="/tutorials/text.html">Text</a></li><li><a href="/tutorials/suggestion-popups.html">Suggestion Popups</a></li><li><a href="/tutorials/text-areas.html">Text Areas</a></li><li><a href="/tuto
rials/separators.html">Separators</a></li><li><a href="/tutorials/layout-containers.html">Layout Containers</a></li><li><a href="/tutorials/flow-panes.html">Flow Panes</a></li><li><a href="/tutorials/box-panes.html">Box Panes</a></li><li><a href="/tutorials/fill-panes.html">Fill Panes</a></li><li><a href="/tutorials/grid-panes.html">Grid Panes</a></li><li><a href="/tutorials/table-panes.html">Table Panes</a></li><li><a href="/tutorials/borders.html">Borders</a></li><li><a href="/tutorials/stack-panes.html">Stack Panes</a></li><li><a href="/tutorials/split-panes.html">Split Panes</a></li><li><a href="/tutorials/forms.html">Forms</a></li><li><a href="/tutorials/panels.html">Panels</a></li><li><a href="/tutorials/navigation-containers.html">Navigation Containers</a></li><li><a href="/tutorials/card-panes.html">Card Panes</a></li><li><a href="/tutorials/tab-panes.html">Tab Panes</a></li><li><a href="/tutorials/accordions.html">Accordions</a></li><li><a href="/tutorials/expanders
.html">Expanders</a></li><li><a href="/tutorials/rollups.html">Rollups</a></li><li><a href="/tutorials/viewports.html">Viewports</a></li><li><a href="/tutorials/scroll-panes.html">Scroll Panes</a></li><li><a href="/tutorials/panoramas.html">Panoramas</a></li><li><a href="/tutorials/progress-indicators.html">Progress Indicators</a></li><li><a href="/tutorials/meters.html">Meters</a></li><li><a href="/tutorials/activity-indicators.html">Activity Indicators</a></li><li><a href="/tutorials/bounded-range-components.html">Bounded Range Components</a></li><li><a href="/tutorials/sliders.html">Sliders</a></li><li><a href="/tutorials/scroll-bars.html">Scroll Bars</a></li><li><a href="/tutorials/spinners.html">Spinners</a></li><li><a href="/tutorials/calendars.html">Calendars</a></li><li><a href="/tutorials/menus.html">Menus</a></li><li><a href="/tutorials/context-menus.html">Context Menus</a></li><li><a href="/tutorials/menu-bars.html">Menu Bars</a></li><li><a href="/tutorials/menu-b
uttons.html">Menu Buttons</a></li><li><a href="/tutorials/color-choosers.html">Color Choosers</a></li><li><a href="/tutorials/table-views.html">Table Views</a></li><li><a href="/tutorials/table-views.json.html">JSON-based TableView</a></li><li><a href="/tutorials/table-views.custom.html">Custom TableView</a></li><li><a href="/tutorials/tree-views.html">Tree Views</a></li><li><a href="/tutorials/file-browsing.html">File Browsing</a></li><li><a href="/tutorials/windows.html">Windows</a></li><li><a href="/tutorials/clipboard.html">Clipboard</a></li><li><a href="/tutorials/drag-and-drop.html">Drag and Drop</a></li><li><a href="/tutorials/effects.html">Effects</a></li><li><a href="/tutorials/effects.transitions.html">Transitions</a></li><li><a href="/tutorials/data-binding.html">Data Binding</a></li><li><a href="/tutorials/property-binding.html">Property Binding</a></li><li><a href="/tutorials/localization.html">Localization</a></li><li><a href="/tutorials/background-tasks.html">
Background Tasks</a></li><li><a href="/tutorials/web-queries.html">Web Queries</a></li><li><a href="/tutorials/query-servlet.html">QueryServlet</a></li><li><a href="/tutorials/scripting.html">Scripting</a></li><li><a href="/tutorials/summary.html">Summary</a></li><li><a href="/tutorials/stock-tracker.html">The "Stock Tracker" Application</a></li><li><a href="/tutorials/stock-tracker.ui.html">UI Markup Using BXML</a></li><li><a href="/tutorials/stock-tracker.events.html">Event Handling</a></li><li><a href="/tutorials/stock-tracker.web-queries.html">Web Queries</a></li><li><a href="/tutorials/stock-tracker.data-binding.html">Data Binding</a></li><li><a href="/tutorials/stock-tracker.localization.html">Localization</a></li><li><a href="/tutorials/bxml-primer.html">BXML Primer</a></li></ul><div class="content"><style type="text/css">
+ applet {
+ border: 1px solid #999999;
+ }
+ </style><!--NOTE: Syntax highlighting script is LGPL--><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shCore.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJava.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushXml.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJScript.js"></script><link type="text/css" rel="stylesheet" href="http://alexgorbatchev.com/pub/sh/current/styles/shCore.css"><link type="text/css" rel="stylesheet" href="http://alexgorbatchev.com/pub/sh/current/styles/shThemeDefault.css"><script type="text/javascript">
+ SyntaxHighlighter.all();
+ </script><div class="section">
+ <p>
+ The following example demonstrates how to use the <tt>Checkbox</tt> class in a Pivot
+ application. Selecting a checkbox shows or hides an associated icon:
+ </p>
+
+ <script type="text/javascript" src="http://java.com/js/deployJava.js"></script><script type="text/javascript">
+
+ var attributes = {
+ code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
+ width:"140",
+ height:"100"
+ };
+
+
+
+
+
+ var libraries = [];
+ libraries.push("/lib/pivot-core-2.0.1.jar");
+ libraries.push("/lib/pivot-wtk-2.0.1.jar");
+ libraries.push("/lib/pivot-wtk-terra-2.0.1.jar");
+ libraries.push("/lib/pivot-tutorials-2.0.1.jar");
+
+ libraries.push("/lib/svgSalamander-tiny.jar");
+
+
+ attributes.archive = libraries.join(",");
+
+
+ var parameters = {
+ codebase_lookup:false,
+ application_class_name:'org.apache.pivot.wtk.ScriptApplication'
+ };
+
+
+ var javaArguments = ["-Dsun.awt.noerasebackground=true",
+ "-Dsun.awt.erasebackgroundonresize=true"];
+
+
+
+ parameters.java_arguments = javaArguments.join(" ");
+
+
+
+ var startupProperties = [];
+
+ startupProperties.push("src=/org/apache/pivot/tutorials/buttons/checkboxes.bxml");
+
+ parameters.startup_properties = startupProperties.join("&");
+
+
+ deployJava.runApplet(attributes, parameters, "1.6");
+ </script>
+
+ <p>
+ The BXML source for the example is below:
+ </p>
+
+ <pre class="brush:xml">
+
+ <Window title="Checkboxes" maximized="true"
+ xmlns:bxml="http://pivot.apache.org/bxml"
+ xmlns="org.apache.pivot.wtk">
+ <TablePane styles="{showHorizontalGridLines: true, showVerticalGridLines:true,
+ padding:4, horizontalSpacing:1, verticalSpacing:1,
+ horizontalGridColor:10, verticalGridColor:10}">
+ <columns>
+ <TablePane.Column width="-1"/>
+ <TablePane.Column width="24"/>
+ </columns>
+
+ <TablePane.Row height="24">
+ <BoxPane styles="{verticalAlignment:'center'}">
+ <Checkbox buttonData="Bell"
+ ButtonPressListener.buttonPressed="bellImageView.setVisible(!bellImageView.isVisible());"/>
+ </BoxPane>
+ <ImageView bxml:id="bellImageView" image="/org/apache/pivot/tutorials/bell.png" visible="false"/>
+ </TablePane.Row>
+
+ <TablePane.Row height="24">
+ <BoxPane styles="{verticalAlignment:'center'}">
+ <Checkbox buttonData="Clock"
+ ButtonPressListener.buttonPressed="clockImageView.setVisible(!clockImageView.isVisible());"/>
+ </BoxPane>
+ <ImageView bxml:id="clockImageView" image="/org/apache/pivot/tutorials/clock.png" visible="false"/>
+ </TablePane.Row>
+
+ <TablePane.Row height="24">
+ <BoxPane styles="{verticalAlignment:'center'}">
+ <Checkbox buttonData="House"
+ ButtonPressListener.buttonPressed="houseImageView.setVisible(!houseImageView.isVisible());"/>
+ </BoxPane>
+ <ImageView bxml:id="houseImageView" image="/org/apache/pivot/tutorials/house.png" visible="false"/>
+ </TablePane.Row>
+ </TablePane>
+ </Window>
+
+ </pre>
+
+ <p>
+ Note that this example uses the <tt>TablePane</tt> layout container. <tt>TablePane</tt>
+ defines a two-dimensional grid structure and is similar to an HTML table. It is
+ discussed in more detail in the <a href="layout-containers.html">Layout Containers</a>
+ section.
+ </p>
+
+ <p>
+ Also note the use of script code to respond to button press events fired by the
+ checkboxes. The <tt>ButtonPressListener.buttonPressed</tt> attribute of each component
+ contains JavaScript code that toggles the visibility of the corresponding image view,
+ causing the image to appear and disappear based on the checkbox's selection state.
+ It is common in Pivot development to implement simple event handlers in script code
+ this way, since it can often be much less verbose than performing the same logic in Java.
+ </p>
+
+ <p>
+ In fact, since all of the logic for this application is implemented in script, there
+ is no Java source associated with this example.
+ </p>
+ </div><p>Next: <a href="link-buttons.html">Link Buttons</a></p></div></div></div><div id="footer" class="group"><div class="footerLogo">Copyright (c) 1999-2012<br>The Apache Software Foundation.</div><div class="footerLinks"><ul class="footerMenuGr"><li><strong>Demos</strong><ul><li><a href="/demos/kitchen-sink.html" target="_new">"Kitchen Sink"</a></li><li><a href="/demos/component-explorer.html" target="_new">Component Explorer</a></li><li><a href="http://cwiki.apache.org/confluence/display/PIVOT/Other+Demos" target="_new">Charting</a></li><li><a href="/demos/">More Demos</a></li></ul></li><li><strong>Documentation</strong><ul><li><a href="/getting-started.html">Getting Started</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/faq.html">FAQ</a></li><li><a href="/2.0.1/docs/api/">Javadoc (2.0.1)</a></li></ul></li><li><strong>Get Involved</strong><ul><li><a href="/svn.html">SVN Repositories</a></li><li><a href="/lists.html">Mailing Lists</a></li><li><a hre
f="http://issues.apache.org/jira/browse/PIVOT">Bug Database</a></li><li><a href="http://cwiki.apache.org/PIVOT/">Wiki</a></li></ul></li><li><strong>Related</strong><ul><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-jfree/">JFreeChart Provider</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-common/">Pivot-Common</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-contrib/">Pivot-Contrib</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-multilang/">Pivot-Multilang</a></li></ul></li><li><strong>About</strong><ul><li><a href="/who-we-are.html">Who We Are</a></li><li><a href="/contact.html">Contact</a></li><li><a href="http://cwiki.apache.org/confluence/display/PIVOT/News">News</a></li><li><a href="/legal.html">Legal/License</a></li></ul></li></ul></div><div class="footerLinks">
+ Apache Pivot is a trademark of the Apache Software Foundation
+ </div></div></div></body></html>
\ No newline at end of file
Modified: pivot/site/trunk/deploy/tutorials/clipboard.html
URL: http://svn.apache.org/viewvc/pivot/site/trunk/deploy/tutorials/clipboard.html?rev=1233143&r1=1233142&r2=1233143&view=diff
==============================================================================
--- pivot/site/trunk/deploy/tutorials/clipboard.html (original)
+++ pivot/site/trunk/deploy/tutorials/clipboard.html Thu Jan 19 00:51:39 2012
@@ -1,4 +1,4 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -14,299 +14,301 @@ distributed under the License is distrib
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
---><html xmlns="http://www.w3.org/1999/xhtml"><head><meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /><title>Clipboard | Apache Pivot</title><link xmlns="" type="text/css" rel="stylesheet" href="/styles/pivot.css"><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript">
- var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
- document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
- </script><script type="text/javascript">
- try {
- var pageTracker = _gat._getTracker("UA-7977275-3");
- pageTracker._trackPageview();
- } catch(err) {}</script></head><body><div xmlns="" id="wrapper"><div id="main"><div id="header"><div class="logo"><a href="/index.html"><img title="Apache Pivot Homepage" alt="Apache Pivot" src="/images/logo.png"></a></div><div class="tagline"><img style="visibility:hidden" alt="Rich Internet Applications in Java" src="/images/tagline.png"></div><ul class="navi"><li><a href="/demos/">Demos</a></li><li><a href="/download.cgi#2.0">Download</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/get-involved.html">Get Involved</a></li><li><a href="/about.html">About</a></li></ul></div><div class="group" id="contentBase"><h1>Clipboard</h1><ul class="naviLeft"><li><a href="/tutorials/sample-application.html">Sample Application</a></li><li><a href="/tutorials/platform-overview.html">Platform Overview</a></li><li><a href="/tutorials/hello-world.html">Hello, World!</a></li><li><a href="/tutorials/hello-bxml.html">Hello, BXML!</a></li><li><a href="/tutorials/
component-and-container.html">Component & Container</a></li><li><a href="/tutorials/labels-and-image-views.html">Labels & Image Views</a></li><li><a href="/tutorials/svg-images.html">SVG Images</a></li><li><a href="/tutorials/buttons.html">Buttons</a></li><li><a href="/tutorials/push-buttons.html">Push Buttons</a></li><li><a href="/tutorials/toggle-buttons.html">Toggle Buttons</a></li><li><a href="/tutorials/radio-buttons.html">Radio Buttons</a></li><li><a href="/tutorials/checkboxes.html">Checkboxes</a></li><li><a href="/tutorials/link-buttons.html">Link Buttons</a></li><li><a href="/tutorials/lists.html">Lists</a></li><li><a href="/tutorials/list-buttons.html">List Buttons</a></li><li><a href="/tutorials/repeatable-list-buttons.html">Repeatable List Buttons</a></li><li><a href="/tutorials/text.html">Text</a></li><li><a href="/tutorials/suggestion-popups.html">Suggestion Popups</a></li><li><a href="/tutorials/text-areas.html">Text Areas</a></li><li><a href="/tutoria
ls/separators.html">Separators</a></li><li><a href="/tutorials/layout-containers.html">Layout Containers</a></li><li><a href="/tutorials/flow-panes.html">Flow Panes</a></li><li><a href="/tutorials/box-panes.html">Box Panes</a></li><li><a href="/tutorials/grid-panes.html">Grid Panes</a></li><li><a href="/tutorials/table-panes.html">Table Panes</a></li><li><a href="/tutorials/borders.html">Borders</a></li><li><a href="/tutorials/stack-panes.html">Stack Panes</a></li><li><a href="/tutorials/split-panes.html">Split Panes</a></li><li><a href="/tutorials/forms.html">Forms</a></li><li><a href="/tutorials/panels.html">Panels</a></li><li><a href="/tutorials/navigation-containers.html">Navigation Containers</a></li><li><a href="/tutorials/card-panes.html">Card Panes</a></li><li><a href="/tutorials/tab-panes.html">Tab Panes</a></li><li><a href="/tutorials/accordions.html">Accordions</a></li><li><a href="/tutorials/expanders.html">Expanders</a></li><li><a href="/tutorials/rollups.html">
Rollups</a></li><li><a href="/tutorials/viewports.html">Viewports</a></li><li><a href="/tutorials/scroll-panes.html">Scroll Panes</a></li><li><a href="/tutorials/panoramas.html">Panoramas</a></li><li><a href="/tutorials/progress-indicators.html">Progress Indicators</a></li><li><a href="/tutorials/meters.html">Meters</a></li><li><a href="/tutorials/activity-indicators.html">Activity Indicators</a></li><li><a href="/tutorials/bounded-range-components.html">Bounded Range Components</a></li><li><a href="/tutorials/sliders.html">Sliders</a></li><li><a href="/tutorials/scroll-bars.html">Scroll Bars</a></li><li><a href="/tutorials/spinners.html">Spinners</a></li><li><a href="/tutorials/calendars.html">Calendars</a></li><li><a href="/tutorials/menus.html">Menus</a></li><li><a href="/tutorials/context-menus.html">Context Menus</a></li><li><a href="/tutorials/menu-bars.html">Menu Bars</a></li><li><a href="/tutorials/menu-buttons.html">Menu Buttons</a></li><li><a href="/tutorials/color
-choosers.html">Color Choosers</a></li><li><a href="/tutorials/table-views.html">Table Views</a></li><li><a href="/tutorials/table-views.json.html">JSON-based TableView</a></li><li><a href="/tutorials/table-views.custom.html">Custom TableView</a></li><li><a href="/tutorials/tree-views.html">Tree Views</a></li><li><a href="/tutorials/file-browsing.html">File Browsing</a></li><li><a href="/tutorials/windows.html">Windows</a></li><li><a href="/tutorials/clipboard.html">Clipboard</a></li><li><a href="/tutorials/drag-and-drop.html">Drag and Drop</a></li><li><a href="/tutorials/effects.html">Effects</a></li><li><a href="/tutorials/effects.transitions.html">Transitions</a></li><li><a href="/tutorials/data-binding.html">Data Binding</a></li><li><a href="/tutorials/property-binding.html">Property Binding</a></li><li><a href="/tutorials/localization.html">Localization</a></li><li><a href="/tutorials/background-tasks.html">Background Tasks</a></li><li><a href="/tutorials/web-queries.ht
ml">Web Queries</a></li><li><a href="/tutorials/query-servlet.html">QueryServlet</a></li><li><a href="/tutorials/scripting.html">Scripting</a></li><li><a href="/tutorials/summary.html">Summary</a></li><li><a href="/tutorials/stock-tracker.html">The "Stock Tracker" Application</a></li><li><a href="/tutorials/stock-tracker.ui.html">UI Markup Using BXML</a></li><li><a href="/tutorials/stock-tracker.events.html">Event Handling</a></li><li><a href="/tutorials/stock-tracker.web-queries.html">Web Queries</a></li><li><a href="/tutorials/stock-tracker.data-binding.html">Data Binding</a></li><li><a href="/tutorials/stock-tracker.localization.html">Localization</a></li><li><a href="/tutorials/bxml-primer.html">BXML Primer</a></li></ul><div class="content"><style type="text/css">
- applet {
- border: 1px solid #999999;
- }
- </style><!--NOTE: Syntax highlighting script is LGPL--><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shCore.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJava.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushXml.js" type="text/javascript"></script><script src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJScript.js" type="text/javascript"></script><link href="http://alexgorbatchev.com/pub/sh/current/styles/shCore.css" rel="stylesheet" type="text/css"><link href="http://alexgorbatchev.com/pub/sh/current/styles/shThemeDefault.css" rel="stylesheet" type="text/css"><script type="text/javascript">
- SyntaxHighlighter.all();
- </script><div class="section">
- <p>
- The clipboard is a shared storage area that can be used to transfer data within an
- application or between multiple applications. Content placed on the clipboard can be
- copied (or "pasted") into another section of an application or into a completely
- different application.
- </p>
-
- <p>
- The following application demonstrates the use of the clipboard. It is signed to allow
- it to access the system clipboard; untrusted Pivot applications can only perform copy
- and paste with a local clipboard whose content is not shared with other applications.
- </p>
-
- <script src="http://java.com/js/deployJava.js" type="text/javascript"></script><script type="text/javascript">
-
- var attributes = {
- code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
- width:"720",
- height:"480"
- };
-
-
-
-
-
- var libraries = [];
- libraries.push("/lib/pivot-core-2.0.signed.jar");
- libraries.push("/lib/pivot-wtk-2.0.signed.jar");
- libraries.push("/lib/pivot-wtk-terra-2.0.signed.jar");
- libraries.push("/lib/pivot-tutorials-2.0.signed.jar");
-
- libraries.push("/lib/svgSalamander-tiny.signed.jar");
-
-
- attributes.archive = libraries.join(",");
-
-
- var parameters = {
- codebase_lookup:false,
- application_class_name:'org.apache.pivot.wtk.ScriptApplication'
- };
-
-
- var javaArguments = ["-Dsun.awt.noerasebackground=true",
- "-Dsun.awt.erasebackgroundonresize=true"];
-
-
-
- parameters.java_arguments = javaArguments.join(" ");
-
-
-
- var startupProperties = [];
-
- startupProperties.push("src=/org/apache/pivot/tutorials/clipboard/clipboard.bxml");
-
- parameters.startup_properties = startupProperties.join("&");
-
-
- deployJava.runApplet(attributes, parameters, "1.6");
- </script>
-
- <p>
- The application source code consists of two files: a main BXML file that declares the
- structure of the user interface along with some simple event handlers, and a JavaScript
- file that defines two functions: <tt>copy()</tt> and <tt>paste()</tt>. These functions
- are invoked by the button press listeners attached to the UI elements declared in the
- BXML file. The BXML source code for the example is shown below:
- </p>
-
- <pre class="brush:xml">
-
- <Window title="Clipboard" maximized="true"
- xmlns:bxml="http://pivot.apache.org/bxml"
- xmlns="org.apache.pivot.wtk">
- <bxml:script src="clipboard.js"/>
-
- <windowStateListeners>
- function windowOpened(window) {
- sourceImageButtonGroup.setSelection(sourceImageButton1);
- sourceImageButton1.requestFocus();
- }
- </windowStateListeners>
-
- <TablePane styles="{horizontalSpacing:4, verticalSpacing:4}">
- <columns>
- <TablePane.Column width="1*"/>
- <TablePane.Column width="1*"/>
- </columns>
-
- <TablePane.Row height="1*">
- <Border styles="{padding:2}">
- <CardPane bxml:id="sourceImageCardPane" styles="{padding:4}">
- <ImageView image="/org/apache/pivot/tutorials/IMG_0725_2.jpg"/>
- <ImageView image="/org/apache/pivot/tutorials/IMG_0735_2.jpg"/>
- <ImageView image="/org/apache/pivot/tutorials/IMG_0767_2.jpg"/>
- </CardPane>
- </Border>
- <Border styles="{padding:2}">
- <CardPane selectedIndex="0" styles="{padding:4}">
- <ImageView bxml:id="destinationImageView"/>
- </CardPane>
- </Border>
- </TablePane.Row>
-
- <TablePane.Row height="-1">
- <BoxPane orientation="vertical" styles="{fill:true}">
- <BoxPane bxml:id="sourceImageButtonBoxPane"
- styles="{horizontalAlignment:'center', verticalAlignment:'center'}">
- <bxml:define>
- <ButtonGroup bxml:id="sourceImageButtonGroup">
- <buttonGroupListeners>
- function selectionChanged(buttonGroup, previousSelection) {
- var selection = buttonGroup.getSelection();
-
- if (selection != null) {
- var index = sourceImageButtonBoxPane.indexOf(selection);
- sourceImageCardPane.setSelectedIndex(index);
- }
- }
- </buttonGroupListeners>
- </ButtonGroup>
- </bxml:define>
-
- <PushButton bxml:id="sourceImageButton1"
- buttonData="IMG_0725_2.jpg" toggleButton="true"
- buttonGroup="$sourceImageButtonGroup"/>
- <PushButton bxml:id="sourceImageButton2"
- buttonData="IMG_0735_2.jpg" toggleButton="true"
- buttonGroup="$sourceImageButtonGroup"/>
- <PushButton bxml:id="sourceImageButton3"
- buttonData="IMG_0767_2.jpg" toggleButton="true"
- buttonGroup="$sourceImageButtonGroup"/>
- </BoxPane>
-
- <BoxPane styles="{horizontalAlignment:'center'}">
- <PushButton bxml:id="copyButton" buttonData="Copy"
- ButtonPressListener.buttonPressed="copy()"/>
- </BoxPane>
- </BoxPane>
-
- <BoxPane styles="{horizontalAlignment:'center', verticalAlignment:'center'}">
- <PushButton bxml:id="pasteButton" buttonData="Paste"
- ButtonPressListener.buttonPressed="paste()"/>
- </BoxPane>
- </TablePane.Row>
- </TablePane>
- </Window>
-
- </pre>
-
- <p>
- Like most Pivot tutorial examples, it defines a single top-level, maximized,
- undecorated <tt>Window</tt> instance that contains the rest of the UI. The source
- images are contained in a set of <tt>ImageView</tt> components stored in a
- <tt>CardPane</tt>, and a set of toggle-style <tt>PushButton</tt>s is used to navigate
- between them. Another <tt>ImageView</tt> is used to display the image content pasted
- from the clipboard.
- </p>
-
- <p>The file defines several event handlers:</p>
-
- <ul>
- <li>
- <p>A window state listener that initializes the selection of the card pane when the window is opened:</p>
-
- <pre class="brush:xml">
-
- <windowStateListeners>
- function windowOpened(window) {
- sourceImageButtonGroup.setSelection(sourceImageButton1);
- sourceImageButton1.requestFocus();
- }
- </windowStateListeners>
-
- </pre>
- </li>
- <li>
- <p>A button group listener that changes the card pane's selection in response to a button group selection change:</p>
- <pre class="brush:xml">
-
- <buttonGroupListeners>
- function selectionChanged(buttonGroup, previousSelection) {
- var selection = buttonGroup.getSelection();
-
- if (selection != null) {
- var index = sourceImageButtonBoxPane.indexOf(selection);
- sourceImageCardPane.setSelectedIndex(index);
- }
- }
- </buttonGroupListeners>
-
- </pre>
- </li>
- <li>
- <p>A button press listener that calls the <tt>copy()</tt> function when the "Copy" button is pressed:</p>
- <pre class="brush:xml">
-
- <PushButton bxml:id="copyButton" buttonData="Copy"
- ButtonPressListener.buttonPressed="copy()"/>
-
- </pre>
- </li>
- <li>
- <p>A button press listener that calls the <tt>paste()</tt> function when the "Paste" button is pressed:</p>
- <pre class="brush:xml">
-
- <PushButton bxml:id="pasteButton" buttonData="Paste"
- ButtonPressListener.buttonPressed="paste()"/>
-
- </pre>
- </li>
- </ul>
-
- <p>
- Since all of the application's logic is implemented in script, there is no Java source
- file for this example. The contents of "clipboard.js" are shown below:
- </p>
-
- <pre class="brush:javascript">
-
- importPackage(org.apache.pivot.wtk);
-
- function copy() {
- // Copy the selected image to the clipboard
- var selectedSourceIndex = sourceImageCardPane.getSelectedIndex();
- var sourceImageView = sourceImageCardPane.get(selectedSourceIndex);
- var sourceImage = sourceImageView.getImage();
-
- var content = new LocalManifest();
- content.putImage(sourceImage);
-
- Clipboard.setContent(content);
- }
-
- function paste() {
- // Paste any available image from the clipboard
- var content = Clipboard.getContent();
-
- if (content != null) {
- var image = content.getImage();
-
- if (image != null) {
- destinationImageView.setImage(image);
- }
- }
-
- </pre>
-
- <p>
- These two functions perform the actual copying and pasting of the image data. The
- <tt>copy()</tt> function gets a reference to the actual image displayed by the selected
- card (an instance of <tt>org.apache.pivot.wtk.media.Image</tt>) and sets it as the
- "image" property of a <tt>LocalManifest</tt> instance. <tt>LocalManifest</tt> is a
- concrete implementation of the abstract <tt>Manifest</tt> class that is used to
- represent the source data in a clipboard transaction. In contrast, a
- <tt>RemoteManifest</tt> represents data obtained from the clipboard. Local manifests
- are created by an application, whereas remote manifests are created by the system.
- </p>
-
- <p>
- A manifest encapsulates the content that may be placed on the clipboard by a Pivot
- application. It can represent the data in a variety of "flavors": as text, as an image,
- as a list of files, as a URL, or as a custom data format. An application may provide
- one or more flavors depending on the nature of the data. An application that is
- interested in consuming the data can then choose the most appropriate format based on
- the available flavors.
- </p>
-
- <p>
- Once the manifest has been created and populated, it is placed on the clipboard via
- the <tt>Clipboard.setContent()</tt> method. It is now available for other applications
- to consume.
- </p>
-
- <p>
- The <tt>paste()</tt> method performs the opposite transaction. It retrieves the current
- clipboard contents and checks for the presence of an image flavor. If available, it
- extracts the image content and sets it as the source of the "destinationImageView"
- component.
- </p>
- </div><p>Next: <a href="drag-and-drop.html">Drag and Drop</a></p></div></div></div><div class="group" id="footer"><div class="footerLogo">Copyright (c) 1999-2011<br>The Apache Software Foundation.</div><div class="footerLinks"><ul class="footerMenuGr"><li><strong>Demos</strong><ul><li><a href="/demos/kitchen-sink.html" target="_new">"Kitchen Sink"</a></li><li><a href="/demos/component-explorer.html" target="_new">Component Explorer</a></li><li><a href="http://ixnay.biz/pivot-jfree-demos/charts_demo.html" target="_new">Charting</a></li><li><a href="/demos/">More Demos</a></li></ul></li><li><strong>Documentation</strong><ul><li><a href="/getting-started.html">Getting Started</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/faq.html">FAQ</a></li><li><a href="/2.0/docs/api/">Javadoc (2.0)</a></li></ul></li><li><strong>Get Involved</strong><ul><li><a href="/svn.html">SVN Repositories</a></li><li><a href="/lists.html">Mailing Lists</a></li><li><a href="http://i
ssues.apache.org/jira/browse/PIVOT">Bug Database</a></li><li><a href="http://cwiki.apache.org/PIVOT/">Wiki</a></li></ul></li><li><strong>Related</strong><ul><li><a href="http://code.google.com/p/pivot-jfree/">JFreeChart Provider</a></li></ul></li><li><strong>About</strong><ul><li><a href="/who-we-are.html">Who We Are</a></li><li><a href="/contact.html">Contact</a></li><li><a href="/news.html">News</a></li><li><a href="/legal.html">Legal/License</a></li></ul></li></ul></div></div></div></body></html>
\ No newline at end of file
+--><html xmlns="http://www.w3.org/1999/xhtml"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Clipboard | Apache Pivot</title><link href="/styles/pivot.css" rel="stylesheet" type="text/css"><script type="text/javascript">
+ var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+ document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+ </script><script type="text/javascript">
+ try {
+ var pageTracker = _gat._getTracker("UA-7977275-3");
+ pageTracker._trackPageview();
+ } catch(err) {}</script></head><body><div id="wrapper"><div id="main"><div id="header"><div xmlns="" class="logo"><a href="/index.html"><img src="/images/logo.png" alt="Apache Pivot" title="Apache Pivot Homepage"></a></div><div class="tagline"><img src="/images/tagline.png" alt="Rich Internet Applications in Java" style="visibility:hidden"></div><ul class="navi"><li><a href="/demos/">Demos</a></li><li><a href="/download.cgi#2.0.1">Download</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/get-involved.html">Get Involved</a></li><li><a href="/about.html">About</a></li></ul></div><div id="contentBase" class="group"><h1>Clipboard</h1><ul class="naviLeft"><li><a href="/tutorials/sample-application.html">Sample Application</a></li><li><a href="/tutorials/platform-overview.html">Platform Overview</a></li><li><a href="/tutorials/hello-world.html">Hello, World!</a></li><li><a href="/tutorials/hello-bxml.html">Hello, BXML!</a></li><li><a href="/tutorial
s/component-and-container.html">Component & Container</a></li><li><a href="/tutorials/labels-and-image-views.html">Labels & Image Views</a></li><li><a href="/tutorials/svg-images.html">SVG Images</a></li><li><a href="/tutorials/buttons.html">Buttons</a></li><li><a href="/tutorials/push-buttons.html">Push Buttons</a></li><li><a href="/tutorials/toggle-buttons.html">Toggle Buttons</a></li><li><a href="/tutorials/radio-buttons.html">Radio Buttons</a></li><li><a href="/tutorials/checkboxes.html">Checkboxes</a></li><li><a href="/tutorials/link-buttons.html">Link Buttons</a></li><li><a href="/tutorials/lists.html">Lists</a></li><li><a href="/tutorials/list-buttons.html">List Buttons</a></li><li><a href="/tutorials/repeatable-list-buttons.html">Repeatable List Buttons</a></li><li><a href="/tutorials/text.html">Text</a></li><li><a href="/tutorials/suggestion-popups.html">Suggestion Popups</a></li><li><a href="/tutorials/text-areas.html">Text Areas</a></li><li><a href="/tutor
ials/separators.html">Separators</a></li><li><a href="/tutorials/layout-containers.html">Layout Containers</a></li><li><a href="/tutorials/flow-panes.html">Flow Panes</a></li><li><a href="/tutorials/box-panes.html">Box Panes</a></li><li><a href="/tutorials/fill-panes.html">Fill Panes</a></li><li><a href="/tutorials/grid-panes.html">Grid Panes</a></li><li><a href="/tutorials/table-panes.html">Table Panes</a></li><li><a href="/tutorials/borders.html">Borders</a></li><li><a href="/tutorials/stack-panes.html">Stack Panes</a></li><li><a href="/tutorials/split-panes.html">Split Panes</a></li><li><a href="/tutorials/forms.html">Forms</a></li><li><a href="/tutorials/panels.html">Panels</a></li><li><a href="/tutorials/navigation-containers.html">Navigation Containers</a></li><li><a href="/tutorials/card-panes.html">Card Panes</a></li><li><a href="/tutorials/tab-panes.html">Tab Panes</a></li><li><a href="/tutorials/accordions.html">Accordions</a></li><li><a href="/tutorials/expanders.
html">Expanders</a></li><li><a href="/tutorials/rollups.html">Rollups</a></li><li><a href="/tutorials/viewports.html">Viewports</a></li><li><a href="/tutorials/scroll-panes.html">Scroll Panes</a></li><li><a href="/tutorials/panoramas.html">Panoramas</a></li><li><a href="/tutorials/progress-indicators.html">Progress Indicators</a></li><li><a href="/tutorials/meters.html">Meters</a></li><li><a href="/tutorials/activity-indicators.html">Activity Indicators</a></li><li><a href="/tutorials/bounded-range-components.html">Bounded Range Components</a></li><li><a href="/tutorials/sliders.html">Sliders</a></li><li><a href="/tutorials/scroll-bars.html">Scroll Bars</a></li><li><a href="/tutorials/spinners.html">Spinners</a></li><li><a href="/tutorials/calendars.html">Calendars</a></li><li><a href="/tutorials/menus.html">Menus</a></li><li><a href="/tutorials/context-menus.html">Context Menus</a></li><li><a href="/tutorials/menu-bars.html">Menu Bars</a></li><li><a href="/tutorials/menu-bu
ttons.html">Menu Buttons</a></li><li><a href="/tutorials/color-choosers.html">Color Choosers</a></li><li><a href="/tutorials/table-views.html">Table Views</a></li><li><a href="/tutorials/table-views.json.html">JSON-based TableView</a></li><li><a href="/tutorials/table-views.custom.html">Custom TableView</a></li><li><a href="/tutorials/tree-views.html">Tree Views</a></li><li><a href="/tutorials/file-browsing.html">File Browsing</a></li><li><a href="/tutorials/windows.html">Windows</a></li><li><a href="/tutorials/clipboard.html">Clipboard</a></li><li><a href="/tutorials/drag-and-drop.html">Drag and Drop</a></li><li><a href="/tutorials/effects.html">Effects</a></li><li><a href="/tutorials/effects.transitions.html">Transitions</a></li><li><a href="/tutorials/data-binding.html">Data Binding</a></li><li><a href="/tutorials/property-binding.html">Property Binding</a></li><li><a href="/tutorials/localization.html">Localization</a></li><li><a href="/tutorials/background-tasks.html">B
ackground Tasks</a></li><li><a href="/tutorials/web-queries.html">Web Queries</a></li><li><a href="/tutorials/query-servlet.html">QueryServlet</a></li><li><a href="/tutorials/scripting.html">Scripting</a></li><li><a href="/tutorials/summary.html">Summary</a></li><li><a href="/tutorials/stock-tracker.html">The "Stock Tracker" Application</a></li><li><a href="/tutorials/stock-tracker.ui.html">UI Markup Using BXML</a></li><li><a href="/tutorials/stock-tracker.events.html">Event Handling</a></li><li><a href="/tutorials/stock-tracker.web-queries.html">Web Queries</a></li><li><a href="/tutorials/stock-tracker.data-binding.html">Data Binding</a></li><li><a href="/tutorials/stock-tracker.localization.html">Localization</a></li><li><a href="/tutorials/bxml-primer.html">BXML Primer</a></li></ul><div class="content"><style type="text/css">
+ applet {
+ border: 1px solid #999999;
+ }
+ </style><!--NOTE: Syntax highlighting script is LGPL--><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shCore.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJava.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushXml.js"></script><script type="text/javascript" src="http://alexgorbatchev.com/pub/sh/current/scripts/shBrushJScript.js"></script><link type="text/css" rel="stylesheet" href="http://alexgorbatchev.com/pub/sh/current/styles/shCore.css"><link type="text/css" rel="stylesheet" href="http://alexgorbatchev.com/pub/sh/current/styles/shThemeDefault.css"><script type="text/javascript">
+ SyntaxHighlighter.all();
+ </script><div class="section">
+ <p>
+ The clipboard is a shared storage area that can be used to transfer data within an
+ application or between multiple applications. Content placed on the clipboard can be
+ copied (or "pasted") into another section of an application or into a completely
+ different application.
+ </p>
+
+ <p>
+ The following application demonstrates the use of the clipboard. It is signed to allow
+ it to access the system clipboard; untrusted Pivot applications can only perform copy
+ and paste with a local clipboard whose content is not shared with other applications.
+ </p>
+
+ <script type="text/javascript" src="http://java.com/js/deployJava.js"></script><script type="text/javascript">
+
+ var attributes = {
+ code:"org.apache.pivot.wtk.BrowserApplicationContext$HostApplet",
+ width:"720",
+ height:"480"
+ };
+
+
+
+
+
+ var libraries = [];
+ libraries.push("/lib/pivot-core-2.0.1.signed.jar");
+ libraries.push("/lib/pivot-wtk-2.0.1.signed.jar");
+ libraries.push("/lib/pivot-wtk-terra-2.0.1.signed.jar");
+ libraries.push("/lib/pivot-tutorials-2.0.1.signed.jar");
+
+ libraries.push("/lib/svgSalamander-tiny.signed.jar");
+
+
+ attributes.archive = libraries.join(",");
+
+
+ var parameters = {
+ codebase_lookup:false,
+ application_class_name:'org.apache.pivot.wtk.ScriptApplication'
+ };
+
+
+ var javaArguments = ["-Dsun.awt.noerasebackground=true",
+ "-Dsun.awt.erasebackgroundonresize=true"];
+
+
+
+ parameters.java_arguments = javaArguments.join(" ");
+
+
+
+ var startupProperties = [];
+
+ startupProperties.push("src=/org/apache/pivot/tutorials/clipboard/clipboard.bxml");
+
+ parameters.startup_properties = startupProperties.join("&");
+
+
+ deployJava.runApplet(attributes, parameters, "1.6");
+ </script>
+
+ <p>
+ The application source code consists of two files: a main BXML file that declares the
+ structure of the user interface along with some simple event handlers, and a JavaScript
+ file that defines two functions: <tt>copy()</tt> and <tt>paste()</tt>. These functions
+ are invoked by the button press listeners attached to the UI elements declared in the
+ BXML file. The BXML source code for the example is shown below:
+ </p>
+
+ <pre class="brush:xml">
+
+ <Window title="Clipboard" maximized="true"
+ xmlns:bxml="http://pivot.apache.org/bxml"
+ xmlns="org.apache.pivot.wtk">
+ <bxml:script src="clipboard.js"/>
+
+ <windowStateListeners>
+ function windowOpened(window) {
+ sourceImageButtonGroup.setSelection(sourceImageButton1);
+ sourceImageButton1.requestFocus();
+ }
+ </windowStateListeners>
+
+ <TablePane styles="{horizontalSpacing:4, verticalSpacing:4}">
+ <columns>
+ <TablePane.Column width="1*"/>
+ <TablePane.Column width="1*"/>
+ </columns>
+
+ <TablePane.Row height="1*">
+ <Border styles="{padding:2}">
+ <CardPane bxml:id="sourceImageCardPane" styles="{padding:4}">
+ <ImageView image="/org/apache/pivot/tutorials/IMG_0725_2.jpg"/>
+ <ImageView image="/org/apache/pivot/tutorials/IMG_0735_2.jpg"/>
+ <ImageView image="/org/apache/pivot/tutorials/IMG_0767_2.jpg"/>
+ </CardPane>
+ </Border>
+ <Border styles="{padding:2}">
+ <CardPane selectedIndex="0" styles="{padding:4}">
+ <ImageView bxml:id="destinationImageView"/>
+ </CardPane>
+ </Border>
+ </TablePane.Row>
+
+ <TablePane.Row height="-1">
+ <BoxPane orientation="vertical" styles="{fill:true}">
+ <BoxPane bxml:id="sourceImageButtonBoxPane"
+ styles="{horizontalAlignment:'center', verticalAlignment:'center'}">
+ <bxml:define>
+ <ButtonGroup bxml:id="sourceImageButtonGroup">
+ <buttonGroupListeners>
+ function selectionChanged(buttonGroup, previousSelection) {
+ var selection = buttonGroup.getSelection();
+
+ if (selection != null) {
+ var index = sourceImageButtonBoxPane.indexOf(selection);
+ sourceImageCardPane.setSelectedIndex(index);
+ }
+ }
+ </buttonGroupListeners>
+ </ButtonGroup>
+ </bxml:define>
+
+ <PushButton bxml:id="sourceImageButton1"
+ buttonData="IMG_0725_2.jpg" toggleButton="true"
+ buttonGroup="$sourceImageButtonGroup"/>
+ <PushButton bxml:id="sourceImageButton2"
+ buttonData="IMG_0735_2.jpg" toggleButton="true"
+ buttonGroup="$sourceImageButtonGroup"/>
+ <PushButton bxml:id="sourceImageButton3"
+ buttonData="IMG_0767_2.jpg" toggleButton="true"
+ buttonGroup="$sourceImageButtonGroup"/>
+ </BoxPane>
+
+ <BoxPane styles="{horizontalAlignment:'center'}">
+ <PushButton bxml:id="copyButton" buttonData="Copy"
+ ButtonPressListener.buttonPressed="copy()"/>
+ </BoxPane>
+ </BoxPane>
+
+ <BoxPane styles="{horizontalAlignment:'center', verticalAlignment:'center'}">
+ <PushButton bxml:id="pasteButton" buttonData="Paste"
+ ButtonPressListener.buttonPressed="paste()"/>
+ </BoxPane>
+ </TablePane.Row>
+ </TablePane>
+ </Window>
+
+ </pre>
+
+ <p>
+ Like most Pivot tutorial examples, it defines a single top-level, maximized,
+ undecorated <tt>Window</tt> instance that contains the rest of the UI. The source
+ images are contained in a set of <tt>ImageView</tt> components stored in a
+ <tt>CardPane</tt>, and a set of toggle-style <tt>PushButton</tt>s is used to navigate
+ between them. Another <tt>ImageView</tt> is used to display the image content pasted
+ from the clipboard.
+ </p>
+
+ <p>The file defines several event handlers:</p>
+
+ <ul>
+ <li>
+ <p>A window state listener that initializes the selection of the card pane when the window is opened:</p>
+
+ <pre class="brush:xml">
+
+ <windowStateListeners>
+ function windowOpened(window) {
+ sourceImageButtonGroup.setSelection(sourceImageButton1);
+ sourceImageButton1.requestFocus();
+ }
+ </windowStateListeners>
+
+ </pre>
+ </li>
+ <li>
+ <p>A button group listener that changes the card pane's selection in response to a button group selection change:</p>
+ <pre class="brush:xml">
+
+ <buttonGroupListeners>
+ function selectionChanged(buttonGroup, previousSelection) {
+ var selection = buttonGroup.getSelection();
+
+ if (selection != null) {
+ var index = sourceImageButtonBoxPane.indexOf(selection);
+ sourceImageCardPane.setSelectedIndex(index);
+ }
+ }
+ </buttonGroupListeners>
+
+ </pre>
+ </li>
+ <li>
+ <p>A button press listener that calls the <tt>copy()</tt> function when the "Copy" button is pressed:</p>
+ <pre class="brush:xml">
+
+ <PushButton bxml:id="copyButton" buttonData="Copy"
+ ButtonPressListener.buttonPressed="copy()"/>
+
+ </pre>
+ </li>
+ <li>
+ <p>A button press listener that calls the <tt>paste()</tt> function when the "Paste" button is pressed:</p>
+ <pre class="brush:xml">
+
+ <PushButton bxml:id="pasteButton" buttonData="Paste"
+ ButtonPressListener.buttonPressed="paste()"/>
+
+ </pre>
+ </li>
+ </ul>
+
+ <p>
+ Since all of the application's logic is implemented in script, there is no Java source
+ file for this example. The contents of "clipboard.js" are shown below:
+ </p>
+
+ <pre class="brush:javascript">
+
+ importPackage(org.apache.pivot.wtk);
+
+ function copy() {
+ // Copy the selected image to the clipboard
+ var selectedSourceIndex = sourceImageCardPane.getSelectedIndex();
+ var sourceImageView = sourceImageCardPane.get(selectedSourceIndex);
+ var sourceImage = sourceImageView.getImage();
+
+ var content = new LocalManifest();
+ content.putImage(sourceImage);
+
+ Clipboard.setContent(content);
+ }
+
+ function paste() {
+ // Paste any available image from the clipboard
+ var content = Clipboard.getContent();
+
+ if (content != null) {
+ var image = content.getImage();
+
+ if (image != null) {
+ destinationImageView.setImage(image);
+ }
+ }
+
+ </pre>
+
+ <p>
+ These two functions perform the actual copying and pasting of the image data. The
+ <tt>copy()</tt> function gets a reference to the actual image displayed by the selected
+ card (an instance of <tt>org.apache.pivot.wtk.media.Image</tt>) and sets it as the
+ "image" property of a <tt>LocalManifest</tt> instance. <tt>LocalManifest</tt> is a
+ concrete implementation of the abstract <tt>Manifest</tt> class that is used to
+ represent the source data in a clipboard transaction. In contrast, a
+ <tt>RemoteManifest</tt> represents data obtained from the clipboard. Local manifests
+ are created by an application, whereas remote manifests are created by the system.
+ </p>
+
+ <p>
+ A manifest encapsulates the content that may be placed on the clipboard by a Pivot
+ application. It can represent the data in a variety of "flavors": as text, as an image,
+ as a list of files, as a URL, or as a custom data format. An application may provide
+ one or more flavors depending on the nature of the data. An application that is
+ interested in consuming the data can then choose the most appropriate format based on
+ the available flavors.
+ </p>
+
+ <p>
+ Once the manifest has been created and populated, it is placed on the clipboard via
+ the <tt>Clipboard.setContent()</tt> method. It is now available for other applications
+ to consume.
+ </p>
+
+ <p>
+ The <tt>paste()</tt> method performs the opposite transaction. It retrieves the current
+ clipboard contents and checks for the presence of an image flavor. If available, it
+ extracts the image content and sets it as the source of the "destinationImageView"
+ component.
+ </p>
+ </div><p>Next: <a href="drag-and-drop.html">Drag and Drop</a></p></div></div></div><div id="footer" class="group"><div class="footerLogo">Copyright (c) 1999-2012<br>The Apache Software Foundation.</div><div class="footerLinks"><ul class="footerMenuGr"><li><strong>Demos</strong><ul><li><a href="/demos/kitchen-sink.html" target="_new">"Kitchen Sink"</a></li><li><a href="/demos/component-explorer.html" target="_new">Component Explorer</a></li><li><a href="http://cwiki.apache.org/confluence/display/PIVOT/Other+Demos" target="_new">Charting</a></li><li><a href="/demos/">More Demos</a></li></ul></li><li><strong>Documentation</strong><ul><li><a href="/getting-started.html">Getting Started</a></li><li><a href="/tutorials/">Tutorial</a></li><li><a href="/faq.html">FAQ</a></li><li><a href="/2.0.1/docs/api/">Javadoc (2.0.1)</a></li></ul></li><li><strong>Get Involved</strong><ul><li><a href="/svn.html">SVN Repositories</a></li><li><a href="/lists.html">Mailing Lists</a></li><li><a h
ref="http://issues.apache.org/jira/browse/PIVOT">Bug Database</a></li><li><a href="http://cwiki.apache.org/PIVOT/">Wiki</a></li></ul></li><li><strong>Related</strong><ul><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-jfree/">JFreeChart Provider</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-common/">Pivot-Common</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-contrib/">Pivot-Contrib</a></li><li><a href="http://code.google.com/a/apache-extras.org/p/pivot-multilang/">Pivot-Multilang</a></li></ul></li><li><strong>About</strong><ul><li><a href="/who-we-are.html">Who We Are</a></li><li><a href="/contact.html">Contact</a></li><li><a href="http://cwiki.apache.org/confluence/display/PIVOT/News">News</a></li><li><a href="/legal.html">Legal/License</a></li></ul></li></ul></div><div class="footerLinks">
+ Apache Pivot is a trademark of the Apache Software Foundation
+ </div></div></div></body></html>
\ No newline at end of file