Modified: poi/site/publish/components/poifs/usecases.html URL: http://svn.apache.org/viewvc/poi/site/publish/components/poifs/usecases.html?rev=1836244&r1=1836243&r2=1836244&view=diff ============================================================================== --- poi/site/publish/components/poifs/usecases.html (original) +++ poi/site/publish/components/poifs/usecases.html Wed Jul 18 23:27:21 2018 @@ -1,179 +1,318 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<!--*** This is a generated file. Do not edit. ***--> -<link rel="stylesheet" href="../skin/tigris.css" type="text/css"> -<link rel="stylesheet" href="../skin/mysite.css" type="text/css"> -<link rel="stylesheet" href="../skin/site.css" type="text/css"> -<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css"> +<meta content="Apache Forrest" name="Generator"> +<meta name="Forrest-version" content="0.9"> +<meta name="Forrest-skin-name" content="pelt"> <title>POIFS Use Cases</title> +<link type="text/css" href="../../skin/basic.css" rel="stylesheet"> +<link media="screen" type="text/css" href="../../skin/screen.css" rel="stylesheet"> +<link media="print" type="text/css" href="../../skin/print.css" rel="stylesheet"> +<link type="text/css" href="../../skin/profile.css" rel="stylesheet"> +<script src="../../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../../skin/fontsize.js" language="javascript" type="text/javascript"></script> +<link rel="shortcut icon" href="../../images/favicon.ico"> </head> -<body bgcolor="white" class="composite"> -<!--================= start Banner ==================--> -<div id="banner"> -<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0"> -<tbody> -<tr> -<!--================= start Group Logo ==================--> -<td width="50%" align="left"> -<div class="groupLogo"> -<a href="https://www.apache.org"><img border="0" class="logoImage" alt="The Apache Software Foundation" src="../resources/images/asf_logo.png"></a> +<body onload="init()"> +<script type="text/javascript">ndeSetTextSize();</script> +<div id="top"> +<!--+ + |breadtrail + +--> +<div class="breadtrail"> +<a href="https://www.apache.org">Apache Software Foundation</a> > <a href="https://poi.apache.org">Apache POI</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script> +</div> +<!--+ + |header + +--> +<div class="header"> +<!--+ + |start group logo + +--> +<div class="grouplogo"> +<a href="https://www.apache.org"><img class="logoImage" alt="Apache Software Foundation" src="../../images/group-logo.png" title="The Apache Software Foundation is a cornerstone of the modern Open Source software ecosystem – supporting some of the most widely used and important software solutions powering today's Internet economy."></a> +</div> +<!--+ + |end group logo + +--> +<!--+ + |start Project Logo + +--> +<div class="projectlogo"> +<a href="https://poi.apache.org"><img class="logoImage" alt="Apache POI" src="../../images/project-logo.png" title="Apache POI is well-known in the Java field as a library for reading and writing Microsoft Office file formats, such as Excel, PowerPoint, Word, Visio, Publisher and Outlook. It supports both the older (OLE2) and new (OOXML - Office Open XML) formats."></a> +</div> +<!--+ + |end Project Logo + +--> +<!--+ + |start Search + +--> +<div class="searchbox"> +<form action="http://www.google.com/search" method="get" class="roundtopsmall"> +<input value="poi.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google"> + <input name="Search" value="Search" type="submit"> +</form> </div> -</td> -<!--================= end Group Logo ==================--> -<!--================= start Project Logo ==================--><td width="50%" align="right"> -<div align="right" class="projectLogo"> -<a href="https://donate.apache.org/"><img border="0" class="logoImage" alt="Support Apache" src="../resources/images/support-asf.png" width="120" height="120" title="Your donation helps The Apache Software Foundation ensure its community-driven software remains available to billions of users at absolutely no cost."></a><a href="https://poi.apache.org/"><img border="0" class="logoImage" alt="Apache POI" src="../resources/images/pb-poi.png" width="120" height="120" title="Apache POI - the Java API for Microsoft Documents"></a> +<!--+ + |end search + +--> +<!--+ + |start Tabs + +--> +<ul id="tabs"> +<li> +<a class="unselected" href="../../index.html">Home</a> +</li> +<li> +<a class="unselected" href="../../help/index.html">Help</a> +</li> +<li class="current"> +<a class="selected" href="../../components/index.html">Component APIs</a> +</li> +<li> +<a class="unselected" href="../../devel/index.html">Getting Involved</a> +</li> +</ul> +<!--+ + |end Tabs + +--> +</div> +</div> +<div id="main"> +<div id="publishedStrip"> +<!--+ + |start Subtabs + +--> +<div id="level2tabs"></div> +<!--+ + |end Endtabs + +--> +<script type="text/javascript"><!-- +document.write("Last Published: " + document.lastModified); +// --></script> +</div> +<!--+ + |breadtrail + +--> +<div class="breadtrail"> + + + </div> +<!--+ + |start Menu, mainarea + +--> +<!--+ + |start Menu + +--> +<div id="menu"> +<div onclick="SwitchMenu('menu_selected_1.1', '../../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Component APIs</div> +<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;"> +<div class="menuitem"> +<a href="../../components/index.html">Overview</a> </div> -</td> -<!--================= end Project Logo ==================--> -</tr> -</tbody> -</table> +<div class="menuitem"> +<a href="../../apidocs/index.html">Javadocs</a> </div> -<!--================= end Banner ==================--> -<!--================= start Main ==================--> -<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs"> -<tbody> -<!--================= start Status ==================--> -<tr class="status"> -<td> -<!--================= start BreadCrumb ==================--><a href="https://www.apache.org/">Apache</a> | <a href="https://poi.apache.org/">POI</a><a href=""></a> -<!--================= end BreadCrumb ==================--></td><td id="tabs"> -<!--================= start Tabs ==================--> -<div class="tab"> -<span class="selectedTab"><a class="base-selected" href="../index.html">Home</a></span> | <script language="Javascript" type="text/javascript"> -function printit() { -if (window.print) { - window.print() ; -} else { - var WebBrowser = '<OBJECT ID="WebBrowser1" WIDTH="0" HEIGHT="0" CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"></OBJECT>'; -document.body.insertAdjacentHTML('beforeEnd', WebBrowser); - WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box WebBrowser1.outerHTML = ""; -} -} -</script><script language="Javascript" type="text/javascript"> -var NS = (navigator.appName == "Netscape"); -var VERSION = parseInt(navigator.appVersion); -if (VERSION > 3) { - document.write(' <a title="PRINT this page OUT" href="javascript:printit()">PRINT</a>'); -} -</script> +<div onclick="SwitchMenu('menu_1.1.3', '../../skin/')" id="menu_1.1.3Title" class="menutitle">Excel (HSSF/XSSF)</div> +<div id="menu_1.1.3" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/spreadsheet/index.html">Overview</a> </div> -<!--================= end Tabs ==================--> -</td> -</tr> -</tbody> -</table> -<!--================= end Status ==================--> -<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0"> -<tbody> -<tr valign="top"> -<!--================= start Menu ==================--> -<td id="leftcol"> -<div id="navcolumn"> -<div class="menuBar"> -<div class="menu"> -<span class="menuLabel">Apache POI</span> - -<div class="menuItem"> -<a href="../index.html">Top</a> +<div class="menuitem"> +<a href="../../components/spreadsheet/quick-guide.html">Quick Guide</a> </div> - +<div class="menuitem"> +<a href="../../components/spreadsheet/how-to.html">HOWTO</a> </div> -<div class="menu"> -<span class="menuLabel">POIFS</span> - -<div class="menuItem"> -<a href="index.html">Overview</a> +<div class="menuitem"> +<a href="../../components/spreadsheet/converting.html">HSSF to SS Converting</a> </div> - -<div class="menuItem"> -<a href="how-to.html">How To</a> +<div class="menuitem"> +<a href="../../components/spreadsheet/formula.html">Formula Support</a> </div> - -<div class="menuItem"> -<a href="embeded.html">Embedded Documents</a> +<div class="menuitem"> +<a href="../../components/spreadsheet/eval.html">Formula Evaluation</a> </div> - -<div class="menuItem"> -<a href="fileformat.html">File System Documentation</a> +<div class="menuitem"> +<a href="../../components/spreadsheet/eval-devguide.html">Eval Dev Guide</a> </div> - -<div class="menuItem"> -<span class="menuSelected">Use Cases</span> +<div class="menuitem"> +<a href="../../components/spreadsheet/examples.html">Examples</a> </div> - +<div class="menuitem"> +<a href="../../components/spreadsheet/use-case.html">Use Case</a> </div> -<center> -<a href="https://www.apache.org/events/current-event.html"><img src="https://www.apache.org/events/current-event-125x125.png"></a> -</center> +<div class="menuitem"> +<a href="../../components/spreadsheet/diagrams.html">Pictorial Docs</a> </div> +<div class="menuitem"> +<a href="../../components/spreadsheet/limitations.html">Limitations</a> </div> -<form target="_blank" action="https://www.google.com/search" method="get"> -<table summary="search" border="0" cellspacing="0" cellpadding="0"> -<tr> -<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"> - Search Apache POI<br> -<input value="poi.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit"></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td> -</tr> -<tr> -<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td> -</tr> -<tr> -<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td> -</tr> -</table> -</form> -</td> -<!--================= end Menu ==================--> -<!--================= start Content ==================--><td> -<div id="bodycol"> -<div class="app"> -<div align="center"> -<h1>POIFS Use Cases</h1> +<div class="menuitem"> +<a href="../../components/spreadsheet/user-defined-functions.html">User Defined Functions</a> </div> -<div class="h3"> - - +<div class="menuitem"> +<a href="../../components/spreadsheet/excelant.html">ExcelAnt Tests</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/hacking-hssf.html">Hacking HSSF</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/record-generator.html">Record Generator</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/chart.html">Charts</a> +</div> +</div> +<div onclick="SwitchMenu('menu_1.1.4', '../../skin/')" id="menu_1.1.4Title" class="menutitle">PowerPoint (HSLF/XSLF)</div> +<div id="menu_1.1.4" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/slideshow/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/slideshow/quick-guide.html">Quick Guide</a> +</div> +<div class="menuitem"> +<a href="../../components/slideshow/how-to-shapes.html">HSLF Cookbook</a> +</div> +<div class="menuitem"> +<a href="../../components/slideshow/xslf-cookbook.html">XSLF Cookbook</a> +</div> +<div class="menuitem"> +<a href="../../components/slideshow/ppt-file-format.html">PPT File Format</a> +</div> +</div> +<div onclick="SwitchMenu('menu_1.1.5', '../../skin/')" id="menu_1.1.5Title" class="menutitle">Word (HWPF/XWPF)</div> +<div id="menu_1.1.5" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/document/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/document/quick-guide.html">HWPF Quick Guide</a> +</div> +<div class="menuitem"> +<a href="../../components/document/quick-guide-xwpf.html">XWPF Quick Guide</a> +</div> +<div class="menuitem"> +<a href="../../components/document/docoverview.html">HWPF Format</a> +</div> +<div class="menuitem"> +<a href="../../components/document/projectplan.html">HWPF Project plan</a> +</div> +</div> +<div class="menuitem"> +<a href="../../components/hsmf/index.html">Outlook (HSMF)</a> +</div> +<div class="menuitem"> +<a href="../../components/diagram/index.html">Visio (HDGF+XDGF)</a> +</div> +<div onclick="SwitchMenu('menu_1.1.8', '../../skin/')" id="menu_1.1.8Title" class="menutitle">Publisher (HPBF)</div> +<div id="menu_1.1.8" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/hpbf/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/hpbf/file-format.html">File Format</a> +</div> +</div> +<div onclick="SwitchMenu('menu_selected_1.1.9', '../../skin/')" id="menu_selected_1.1.9Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">OLE2 Filesystem (POIFS)</div> +<div id="menu_selected_1.1.9" class="selectedmenuitemgroup" style="display: block;"> +<div class="menuitem"> +<a href="../../components/poifs/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/how-to.html">How To</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/embeded.html">Embedded Documents</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/fileformat.html">File System Documentation</a> +</div> +<div class="menupage"> +<div class="menupagetitle">Use Cases</div> +</div> +<div class="menuitem"> +<a href="../../components/poifs/design.html">Design</a> +</div> +</div> +<div onclick="SwitchMenu('menu_1.1.10', '../../skin/')" id="menu_1.1.10Title" class="menutitle">OLE2 Document Props (HPSF)</div> +<div id="menu_1.1.10" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/hpsf/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/how-to.html">How To</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/thumbnails.html">Thumbnails</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/internals.html">Internals</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/todo.html">To Do</a> +</div> +</div> +<div class="menuitem"> +<a href="../../components/hmef/index.html">TNEF (HMEF) for winmail.dat</a> +</div> +<div class="menuitem"> +<a href="../../components/oxml4j/index.html">OpenXML4J (OOXML)</a> +</div> +<div class="menuitem"> +<a href="../../components/logging.html">Logging framework</a> +</div> +</div> +<div id="credit"></div> +<div id="roundbottom"> +<img style="display: none" class="corner" height="15" width="15" alt="" src="../../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div> +<!--+ + |alternative credits + +--> +<div id="credit2"> +<a href="https://donate.apache.org/"><img border="0" title="Support Apache" alt="Support Apache - logo" src="../../images/support-asf.png" style="width: 125px;height: 125px;"></a> +</div> +</div> +<!--+ + |end Menu + +--> +<!--+ + |start content + +--> +<div id="content"> +<h1>POIFS Use Cases</h1> +<div id="front-matter"></div> <a name="POIFS+Use+Cases"></a> -<div class="h3"> -<h3>POIFS Use Cases<a title="Permanent link" class="headerlink" href="#POIFS+Use+Cases">#</a> -</h3> -</div> - +<h2 class="boxed">POIFS Use Cases</h2> +<div class="section"> <a name="Use+Case+1%3A+Read+existing+file+system"></a> -<div class="h4"> -<h4>Use Case 1: Read existing file system<a title="Permanent link" class="headerlink" href="#Use+Case+1%3A+Read+existing+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 1: Read existing file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -184,21 +323,21 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -233,7 +372,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1"> @@ -253,38 +392,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+2%3A+Write+file+system"></a> -<div class="h4"> -<h4>Use Case 2: Write file system<a title="Permanent link" class="headerlink" href="#Use+Case+2%3A+Write+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 2: Write file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Primary Actor:</th> <th colspan="1" rowspan="1">POIFS client</th> </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Scope:</th> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Level:</th> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Stakeholders and Interests:</th> <td colspan="1" rowspan="1"> @@ -294,7 +427,7 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Precondition:</th> <td colspan="1" rowspan="1"> @@ -311,14 +444,14 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Minimal Guarantee:</th> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Main Success Guarantee:</th> <td colspan="1" rowspan="1"> @@ -351,7 +484,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Extensions:</th> <td colspan="1" rowspan="1"> @@ -389,38 +522,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+3%3A+Create+new+file+system"></a> -<div class="h4"> -<h4>Use Case 3: Create new file system<a title="Permanent link" class="headerlink" href="#Use+Case+3%3A+Create+new+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 3: Create new file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Primary Actor:</th> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Scope:</th> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Level:</th> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Stakeholders and Interests:</th> <td colspan="1" rowspan="1"> @@ -431,21 +558,21 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Precondition:</th> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Minimal Guarantee:</th> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <th colspan="1" rowspan="1">Main Success Guarantee:</th> <td colspan="1" rowspan="1"> @@ -454,7 +581,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <th colspan="1" rowspan="1">Extensions:</th> <td colspan="1" rowspan="1">None</td> @@ -462,38 +589,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+4%3A+Replace+file+in+file+system"></a> -<div class="h4"> -<h4>Use Case 4: Replace file in file system<a title="Permanent link" class="headerlink" href="#Use+Case+4%3A+Replace+file+in+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 4: Replace file in file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -504,7 +625,7 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1"> @@ -526,14 +647,14 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -545,7 +666,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1"> @@ -556,38 +677,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+5%3A+Delete+file+from+file+system"></a> -<div class="h4"> -<h4>Use Case 5: Delete file from file system<a title="Permanent link" class="headerlink" href="#Use+Case+5%3A+Delete+file+from+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 5: Delete file from file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -598,7 +713,7 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1"> @@ -621,14 +736,14 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -639,7 +754,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1"> @@ -650,38 +765,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+6%3A+Write+new+file+to+file+system"></a> -<div class="h4"> -<h4>Use Case 6: Write new file to file system<a title="Permanent link" class="headerlink" href="#Use+Case+6%3A+Write+new+file+to+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 6: Write new file to file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -692,7 +801,7 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1">The specified file does not yet exist in the file @@ -700,14 +809,14 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -727,7 +836,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1"> @@ -742,38 +851,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+7%3A+Read+existing+file+from+file+system"></a> -<div class="h4"> -<h4>Use Case 7: Read existing file from file system<a title="Permanent link" class="headerlink" href="#Use+Case+7%3A+Read+existing+file+from+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 7: Read existing file from file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -784,7 +887,7 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1"> @@ -797,14 +900,14 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -816,7 +919,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1">1a. POIFS throws an exception if no file with the @@ -825,38 +928,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+8%3A+Read+file+system+directory"></a> -<div class="h4"> -<h4>Use Case 8: Read file system directory<a title="Permanent link" class="headerlink" href="#Use+Case+8%3A+Read+file+system+directory">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 8: Read file system directory</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -867,7 +964,7 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1">The file system has been read (use case 1, read @@ -876,14 +973,14 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -898,7 +995,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1">None</td> @@ -906,38 +1003,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+9%3A+Read+file"></a> -<div class="h4"> -<h4>Use Case 9: Read file<a title="Permanent link" class="headerlink" href="#Use+Case+9%3A+Read+file">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 9: Read file</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -949,21 +1040,21 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -983,7 +1074,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1">3a. An exception will be thrown if the specified Block @@ -994,38 +1085,32 @@ if (VERSION > 3) { </tr> </table> - - <a name="Use+Case+10%3A+Rename+existing+file+in+the+file+system"></a> -<div class="h4"> -<h4>Use Case 10: Rename existing file in the file system<a title="Permanent link" class="headerlink" href="#Use+Case+10%3A+Rename+existing+file+in+the+file+system">#</a> -</h4> -</div> - +<h3 class="boxed">Use Case 10: Rename existing file in the file system</h3> <table class="ForrestTable" cellspacing="1" cellpadding="4"> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Primary Actor:</em></td> <td colspan="1" rowspan="1">POIFS client</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Scope:</em></td> <td colspan="1" rowspan="1">POIFS</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Level:</em></td> <td colspan="1" rowspan="1">Summary</td> </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Stakeholders and Interests:</em></td> <td colspan="1" rowspan="1"> @@ -1036,7 +1121,7 @@ if (VERSION > 3) { </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Precondition:</em></td> <td colspan="1" rowspan="1"> @@ -1051,14 +1136,14 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Minimal Guarantee:</em></td> <td colspan="1" rowspan="1">None</td> </tr> -<tr class="b"> +<tr> <td colspan="1" rowspan="1"><em>Main Success Guarantee:</em></td> <td colspan="1" rowspan="1"> @@ -1068,7 +1153,7 @@ if (VERSION > 3) { </tr> -<tr class="a"> +<tr> <td colspan="1" rowspan="1"><em>Extensions:</em></td> <td colspan="1" rowspan="1"> @@ -1083,51 +1168,37 @@ if (VERSION > 3) { </tr> </table> - - - - -<div id="authors" align="right">by Marc Johnson</div> -</div> </div> + +<p align="right"> +<font size="-2">by Marc Johnson</font> +</p> +</div> +<!--+ + |end content + +--> +<div class="clearboth"> </div> </div> -</td> -<!--================= end Content ==================--> -</tr> -</tbody> -</table> -<!--================= end Main ==================--> -<!--================= start Footer ==================--> <div id="footer"> -<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0"> -<tbody> -<tr> -<!--================= start Copyright ==================--> -<td colspan="2"> -<div align="center"> -<div class="copyright"> - Copyright © 2002-2018 The Apache Software Foundation. All rights reserved.<br> - Apache, Apache POI, and the Apache POI logo are registered trademarks or - trademarks of The Apache Software Foundation in the U.S. and/or other countries. - </div> +<!--+ + |start bottomstrip + +--> +<div class="lastmodified"> +<script type="text/javascript"><!-- +document.write("Last Published: " + document.lastModified); +// --></script> </div> -</td> -<!--================= end Copyright ==================--> -</tr> -<tr> -<td align="left"> -<!--================= start Host ==================--> -<!--================= end Host ==================--></td><td align="right"> -<!--================= start Credits ==================--> -<div align="right"> -<div class="credit"></div> +<div class="copyright"> + Copyright © + 2001-2018 <a href="https://www.apache.org/">The Apache Software Foundation</a> </div> -<!--================= end Credits ==================--> -</td> -</tr> -</tbody> -</table> +<div id="feedback"> + Send feedback about the website to: + <a id="feedbackto" href="mailto:[email protected]?subject=Feedback%C2%A0components/poifs/usecases.html">[email protected]</a> +</div> +<!--+ + |end bottomstrip + +--> </div> -<!--================= end Footer ==================--> </body> </html>
Modified: poi/site/publish/components/slideshow/how-to-shapes.html URL: http://svn.apache.org/viewvc/poi/site/publish/components/slideshow/how-to-shapes.html?rev=1836244&r1=1836243&r2=1836244&view=diff ============================================================================== --- poi/site/publish/components/slideshow/how-to-shapes.html (original) +++ poi/site/publish/components/slideshow/how-to-shapes.html Wed Jul 18 23:27:21 2018 @@ -1,147 +1,294 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<!--*** This is a generated file. Do not edit. ***--> -<link rel="stylesheet" href="../skin/tigris.css" type="text/css"> -<link rel="stylesheet" href="../skin/mysite.css" type="text/css"> -<link rel="stylesheet" href="../skin/site.css" type="text/css"> -<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css"> +<meta content="Apache Forrest" name="Generator"> +<meta name="Forrest-version" content="0.9"> +<meta name="Forrest-skin-name" content="pelt"> <title>Busy Developers' Guide to HSLF drawing layer</title> +<link type="text/css" href="../../skin/basic.css" rel="stylesheet"> +<link media="screen" type="text/css" href="../../skin/screen.css" rel="stylesheet"> +<link media="print" type="text/css" href="../../skin/print.css" rel="stylesheet"> +<link type="text/css" href="../../skin/profile.css" rel="stylesheet"> +<script src="../../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../../skin/fontsize.js" language="javascript" type="text/javascript"></script> +<link rel="shortcut icon" href="../../images/favicon.ico"> </head> -<body bgcolor="white" class="composite"> -<!--================= start Banner ==================--> -<div id="banner"> -<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0"> -<tbody> -<tr> -<!--================= start Group Logo ==================--> -<td width="50%" align="left"> -<div class="groupLogo"> -<a href="https://www.apache.org"><img border="0" class="logoImage" alt="The Apache Software Foundation" src="../resources/images/asf_logo.png"></a> -</div> -</td> -<!--================= end Group Logo ==================--> -<!--================= start Project Logo ==================--><td width="50%" align="right"> -<div align="right" class="projectLogo"> -<a href="https://donate.apache.org/"><img border="0" class="logoImage" alt="Support Apache" src="../resources/images/support-asf.png" width="120" height="120" title="Your donation helps The Apache Software Foundation ensure its community-driven software remains available to billions of users at absolutely no cost."></a><a href="https://poi.apache.org/"><img border="0" class="logoImage" alt="Apache POI" src="../resources/images/pb-poi.png" width="120" height="120" title="Apache POI - the Java API for Microsoft Documents"></a> -</div> -</td> -<!--================= end Project Logo ==================--> -</tr> -</tbody> -</table> -</div> -<!--================= end Banner ==================--> -<!--================= start Main ==================--> -<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs"> -<tbody> -<!--================= start Status ==================--> -<tr class="status"> -<td> -<!--================= start BreadCrumb ==================--><a href="https://www.apache.org/">Apache</a> | <a href="https://poi.apache.org/">POI</a><a href=""></a> -<!--================= end BreadCrumb ==================--></td><td id="tabs"> -<!--================= start Tabs ==================--> -<div class="tab"> -<span class="selectedTab"><a class="base-selected" href="../index.html">Home</a></span> | <script language="Javascript" type="text/javascript"> -function printit() { -if (window.print) { - window.print() ; -} else { - var WebBrowser = '<OBJECT ID="WebBrowser1" WIDTH="0" HEIGHT="0" CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"></OBJECT>'; -document.body.insertAdjacentHTML('beforeEnd', WebBrowser); - WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box WebBrowser1.outerHTML = ""; -} -} -</script><script language="Javascript" type="text/javascript"> -var NS = (navigator.appName == "Netscape"); -var VERSION = parseInt(navigator.appVersion); -if (VERSION > 3) { - document.write(' <a title="PRINT this page OUT" href="javascript:printit()">PRINT</a>'); -} -</script> -</div> -<!--================= end Tabs ==================--> -</td> -</tr> -</tbody> -</table> -<!--================= end Status ==================--> -<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0"> -<tbody> -<tr valign="top"> -<!--================= start Menu ==================--> -<td id="leftcol"> -<div id="navcolumn"> -<div class="menuBar"> -<div class="menu"> -<span class="menuLabel">Apache POI</span> -<div class="menuItem"> -<a href="../index.html">Top</a> -</div> -</div> -<div class="menu"> -<span class="menuLabel">HSLF</span> -<div class="menuItem"> -<a href="index.html">Overview</a> -</div> -<div class="menuItem"> -<a href="quick-guide.html">Quick Guide</a> -</div> -<div class="menuItem"> -<span class="menuSelected">HSLF Cookbook</span> -</div> -<div class="menuItem"> -<a href="xslf-cookbook.html">XSLF Cookbook</a> -</div> -<div class="menuItem"> -<a href="ppt-file-format.html">PPT File Format</a> -</div> -</div> -<center> -<a href="https://www.apache.org/events/current-event.html"><img src="https://www.apache.org/events/current-event-125x125.png"></a> -</center> -</div> -</div> -<form target="_blank" action="https://www.google.com/search" method="get"> -<table summary="search" border="0" cellspacing="0" cellpadding="0"> -<tr> -<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"> - Search Apache POI<br> -<input value="poi.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit"></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td> -</tr> -<tr> -<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td> -</tr> -<tr> -<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td> -</tr> -</table> +<body onload="init()"> +<script type="text/javascript">ndeSetTextSize();</script> +<div id="top"> +<!--+ + |breadtrail + +--> +<div class="breadtrail"> +<a href="https://www.apache.org">Apache Software Foundation</a> > <a href="https://poi.apache.org">Apache POI</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script> +</div> +<!--+ + |header + +--> +<div class="header"> +<!--+ + |start group logo + +--> +<div class="grouplogo"> +<a href="https://www.apache.org"><img class="logoImage" alt="Apache Software Foundation" src="../../images/group-logo.png" title="The Apache Software Foundation is a cornerstone of the modern Open Source software ecosystem – supporting some of the most widely used and important software solutions powering today's Internet economy."></a> +</div> +<!--+ + |end group logo + +--> +<!--+ + |start Project Logo + +--> +<div class="projectlogo"> +<a href="https://poi.apache.org"><img class="logoImage" alt="Apache POI" src="../../images/project-logo.png" title="Apache POI is well-known in the Java field as a library for reading and writing Microsoft Office file formats, such as Excel, PowerPoint, Word, Visio, Publisher and Outlook. It supports both the older (OLE2) and new (OOXML - Office Open XML) formats."></a> +</div> +<!--+ + |end Project Logo + +--> +<!--+ + |start Search + +--> +<div class="searchbox"> +<form action="http://www.google.com/search" method="get" class="roundtopsmall"> +<input value="poi.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google"> + <input name="Search" value="Search" type="submit"> </form> -</td> -<!--================= end Menu ==================--> -<!--================= start Content ==================--><td> -<div id="bodycol"> -<div class="app"> -<div align="center"> -<h1>Busy Developers' Guide to HSLF drawing layer</h1> </div> -<div class="h3"> - - +<!--+ + |end search + +--> +<!--+ + |start Tabs + +--> +<ul id="tabs"> +<li> +<a class="unselected" href="../../index.html">Home</a> +</li> +<li> +<a class="unselected" href="../../help/index.html">Help</a> +</li> +<li class="current"> +<a class="selected" href="../../components/index.html">Component APIs</a> +</li> +<li> +<a class="unselected" href="../../devel/index.html">Getting Involved</a> +</li> +</ul> +<!--+ + |end Tabs + +--> +</div> +</div> +<div id="main"> +<div id="publishedStrip"> +<!--+ + |start Subtabs + +--> +<div id="level2tabs"></div> +<!--+ + |end Endtabs + +--> +<script type="text/javascript"><!-- +document.write("Last Published: " + document.lastModified); +// --></script> +</div> +<!--+ + |breadtrail + +--> +<div class="breadtrail"> + + + </div> +<!--+ + |start Menu, mainarea + +--> +<!--+ + |start Menu + +--> +<div id="menu"> +<div onclick="SwitchMenu('menu_selected_1.1', '../../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Component APIs</div> +<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;"> +<div class="menuitem"> +<a href="../../components/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../apidocs/index.html">Javadocs</a> +</div> +<div onclick="SwitchMenu('menu_1.1.3', '../../skin/')" id="menu_1.1.3Title" class="menutitle">Excel (HSSF/XSSF)</div> +<div id="menu_1.1.3" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/spreadsheet/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/quick-guide.html">Quick Guide</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/how-to.html">HOWTO</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/converting.html">HSSF to SS Converting</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/formula.html">Formula Support</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/eval.html">Formula Evaluation</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/eval-devguide.html">Eval Dev Guide</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/examples.html">Examples</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/use-case.html">Use Case</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/diagrams.html">Pictorial Docs</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/limitations.html">Limitations</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/user-defined-functions.html">User Defined Functions</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/excelant.html">ExcelAnt Tests</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/hacking-hssf.html">Hacking HSSF</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/record-generator.html">Record Generator</a> +</div> +<div class="menuitem"> +<a href="../../components/spreadsheet/chart.html">Charts</a> +</div> +</div> +<div onclick="SwitchMenu('menu_selected_1.1.4', '../../skin/')" id="menu_selected_1.1.4Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">PowerPoint (HSLF/XSLF)</div> +<div id="menu_selected_1.1.4" class="selectedmenuitemgroup" style="display: block;"> +<div class="menuitem"> +<a href="../../components/slideshow/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/slideshow/quick-guide.html">Quick Guide</a> +</div> +<div class="menupage"> +<div class="menupagetitle">HSLF Cookbook</div> +</div> +<div class="menuitem"> +<a href="../../components/slideshow/xslf-cookbook.html">XSLF Cookbook</a> +</div> +<div class="menuitem"> +<a href="../../components/slideshow/ppt-file-format.html">PPT File Format</a> +</div> +</div> +<div onclick="SwitchMenu('menu_1.1.5', '../../skin/')" id="menu_1.1.5Title" class="menutitle">Word (HWPF/XWPF)</div> +<div id="menu_1.1.5" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/document/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/document/quick-guide.html">HWPF Quick Guide</a> +</div> +<div class="menuitem"> +<a href="../../components/document/quick-guide-xwpf.html">XWPF Quick Guide</a> +</div> +<div class="menuitem"> +<a href="../../components/document/docoverview.html">HWPF Format</a> +</div> +<div class="menuitem"> +<a href="../../components/document/projectplan.html">HWPF Project plan</a> +</div> +</div> +<div class="menuitem"> +<a href="../../components/hsmf/index.html">Outlook (HSMF)</a> +</div> +<div class="menuitem"> +<a href="../../components/diagram/index.html">Visio (HDGF+XDGF)</a> +</div> +<div onclick="SwitchMenu('menu_1.1.8', '../../skin/')" id="menu_1.1.8Title" class="menutitle">Publisher (HPBF)</div> +<div id="menu_1.1.8" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/hpbf/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/hpbf/file-format.html">File Format</a> +</div> +</div> +<div onclick="SwitchMenu('menu_1.1.9', '../../skin/')" id="menu_1.1.9Title" class="menutitle">OLE2 Filesystem (POIFS)</div> +<div id="menu_1.1.9" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/poifs/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/how-to.html">How To</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/embeded.html">Embedded Documents</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/fileformat.html">File System Documentation</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/usecases.html">Use Cases</a> +</div> +<div class="menuitem"> +<a href="../../components/poifs/design.html">Design</a> +</div> +</div> +<div onclick="SwitchMenu('menu_1.1.10', '../../skin/')" id="menu_1.1.10Title" class="menutitle">OLE2 Document Props (HPSF)</div> +<div id="menu_1.1.10" class="menuitemgroup"> +<div class="menuitem"> +<a href="../../components/hpsf/index.html">Overview</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/how-to.html">How To</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/thumbnails.html">Thumbnails</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/internals.html">Internals</a> +</div> +<div class="menuitem"> +<a href="../../components/hpsf/todo.html">To Do</a> +</div> +</div> +<div class="menuitem"> +<a href="../../components/hmef/index.html">TNEF (HMEF) for winmail.dat</a> +</div> +<div class="menuitem"> +<a href="../../components/oxml4j/index.html">OpenXML4J (OOXML)</a> +</div> +<div class="menuitem"> +<a href="../../components/logging.html">Logging framework</a> +</div> +</div> +<div id="credit"></div> +<div id="roundbottom"> +<img style="display: none" class="corner" height="15" width="15" alt="" src="../../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div> +<!--+ + |alternative credits + +--> +<div id="credit2"> +<a href="https://donate.apache.org/"><img border="0" title="Support Apache" alt="Support Apache - logo" src="../../images/support-asf.png" style="width: 125px;height: 125px;"></a> +</div> +</div> +<!--+ + |end Menu + +--> +<!--+ + |start content + +--> +<div id="content"> +<h1>Busy Developers' Guide to HSLF drawing layer</h1> +<div id="front-matter"></div> <a name="Busy+Developers%27+Guide+to+HSLF+drawing+layer"></a> -<div class="h3"> -<h3>Busy Developers' Guide to HSLF drawing layer<a title="Permanent link" class="headerlink" href="#Busy+Developers%27+Guide+to+HSLF+drawing+layer">#</a> -</h3> -</div> - +<h2 class="boxed">Busy Developers' Guide to HSLF drawing layer</h2> +<div class="section"> <a name="Index+of+Features"></a> -<div class="h4"> -<h4>Index of Features<a title="Permanent link" class="headerlink" href="#Index+of+Features">#</a> -</h4> -</div> - +<h3 class="boxed">Index of Features</h3> <ul> <li> @@ -213,21 +360,10 @@ if (VERSION > 3) { </li> </ul> - - <a name="Features"></a> -<div class="h4"> -<h4>Features<a title="Permanent link" class="headerlink" href="#Features">#</a> -</h4> -</div> - -<a name="NewPresentation"></a> - <a name="New+Presentation"></a> -<div class="h2"> -<h2>New Presentation<a title="Permanent link" class="headerlink" href="#New+Presentation">#</a> -</h2> -</div> - +<h3 class="boxed">Features</h3> +<a name="NewPresentation" id="NewPresentation"></a><a name="New+Presentation"></a> +<h4>New Presentation</h4> <pre class="code"> //create a new empty slide show HSLFSlideShow ppt = new HSLFSlideShow(); @@ -243,15 +379,8 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - - -<a name="PageSize"></a> - <a name="How+to+retrieve+or+change+slide+size"></a> -<div class="h2"> -<h2>How to retrieve or change slide size<a title="Permanent link" class="headerlink" href="#How+to+retrieve+or+change+slide+size">#</a> -</h2> -</div> - +<a name="PageSize" id="PageSize"></a><a name="How+to+retrieve+or+change+slide+size"></a> +<h4>How to retrieve or change slide size</h4> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(new HSLFSlideShowImpl("slideshow.ppt")); //retrieve page size. Coordinates are expressed in points (72 dpi) @@ -266,19 +395,11 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - - -<a name="GetShapes"></a> - <a name="How+to+get+shapes+contained+in+a+particular+slide"></a> -<div class="h2"> -<h2>How to get shapes contained in a particular slide<a title="Permanent link" class="headerlink" href="#How+to+get+shapes+contained+in+a+particular+slide">#</a> -</h2> -</div> - +<a name="GetShapes" id="GetShapes"></a><a name="How+to+get+shapes+contained+in+a+particular+slide"></a> +<h4>How to get shapes contained in a particular slide</h4> <p> The following code demonstrates how to iterate over shapes for each slide. </p> - <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(new HSLFSlideShowImpl("slideshow.ppt")); // get slides @@ -306,16 +427,9 @@ if (VERSION > 3) { } } </pre> - - -<a name="Shapes"></a> - <a name="Drawing+a+shape+on+a+slide"></a> -<div class="h2"> -<h2>Drawing a shape on a slide<a title="Permanent link" class="headerlink" href="#Drawing+a+shape+on+a+slide">#</a> -</h2> -</div> - -<div class="frame warning"> +<a name="Shapes" id="Shapes"></a><a name="Drawing+a+shape+on+a+slide"></a> +<h4>Drawing a shape on a slide</h4> +<div class="warning"> <div class="label">Warning</div> <div class="content"> To work with graphic objects HSLF uses Java2D classes @@ -325,13 +439,11 @@ if (VERSION > 3) { (either via <span class="codefrag">-Djava.awt.headless=true</span> startup parameter or via <span class="codefrag">System.setProperty("java.awt.headless", "true")</span>). </div> </div> - <p> When you add a shape, you usually specify the dimensions of the shape and the position of the upper left corner of the bounding box for the shape relative to the upper left corner of the slide. Distances in the drawing layer are measured in points (72 points = 1 inch). </p> - <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); @@ -379,20 +491,11 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - - -<a name="Pictures"></a> - <a name="How+to+work+with+pictures"></a> -<div class="h2"> -<h2>How to work with pictures<a title="Permanent link" class="headerlink" href="#How+to+work+with+pictures">#</a> -</h2> -</div> - - +<a name="Pictures" id="Pictures"></a><a name="How+to+work+with+pictures"></a> +<h4>How to work with pictures</h4> <p> Currently, HSLF API supports the following types of pictures: </p> - <ul> <li>Windows Metafiles (WMF)</li> @@ -406,8 +509,6 @@ if (VERSION > 3) { <li>Macintosh PICT</li> </ul> - - <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(new HSLFSlideShowImpl("slideshow.ppt")); @@ -456,15 +557,8 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - - -<a name="SlideTitle"></a> - <a name="How+to+set+slide+title"></a> -<div class="h2"> -<h2>How to set slide title<a title="Permanent link" class="headerlink" href="#How+to+set+slide+title">#</a> -</h2> -</div> - +<a name="SlideTitle" id="SlideTitle"></a><a name="How+to+set+slide+title"></a> +<h4>How to set slide title</h4> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); HSLFSlide slide = ppt.createSlide(); @@ -476,24 +570,15 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - <p> Below is the equivalent code in PowerPoint VBA: - </p> - + </p> <pre class="code"> Set myDocument = ActivePresentation.Slides(1) myDocument.Shapes.AddTitle.TextFrame.TextRange.Text = "Hello, World!" </pre> - - -<a name="Fill"></a> - <a name="How+to+modify+background+of+a+slide+master"></a> -<div class="h2"> -<h2>How to modify background of a slide master<a title="Permanent link" class="headerlink" href="#How+to+modify+background+of+a+slide+master">#</a> -</h2> -</div> - +<a name="Fill" id="Fill"></a><a name="How+to+modify+background+of+a+slide+master"></a> +<h4>How to modify background of a slide master</h4> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); HSLFSlideMaster master = ppt.getSlideMasters().get(0); @@ -503,14 +588,8 @@ if (VERSION > 3) { fill.setFillType(HSLFFill.FILL_PICTURE); fill.setPictureData(pd); </pre> - - <a name="How+to+modify+background+of+a+slide"></a> -<div class="h2"> -<h2>How to modify background of a slide<a title="Permanent link" class="headerlink" href="#How+to+modify+background+of+a+slide">#</a> -</h2> -</div> - +<h4>How to modify background of a slide</h4> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); HSLFSlide slide = ppt.createSlide(); @@ -523,14 +602,8 @@ if (VERSION > 3) { fill.setFillType(HSLFFill.FILL_PATTERN); fill.setPictureData(pd); </pre> - - <a name="How+to+modify+background+of+a+shape"></a> -<div class="h2"> -<h2>How to modify background of a shape<a title="Permanent link" class="headerlink" href="#How+to+modify+background+of+a+shape">#</a> -</h2> -</div> - +<h4>How to modify background of a shape</h4> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); HSLFSlide slide = ppt.createSlide(); @@ -544,15 +617,8 @@ if (VERSION > 3) { slide.addShape(shape); </pre> - - -<a name="Bullets"></a> - <a name="How+to+create+bulleted+lists"></a> -<div class="h2"> -<h2>How to create bulleted lists<a title="Permanent link" class="headerlink" href="#How+to+create+bulleted+lists">#</a> -</h2> -</div> - +<a name="Bullets" id="Bullets"></a><a name="How+to+create+bulleted+lists"></a> +<h4>How to create bulleted lists</h4> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); @@ -580,15 +646,8 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - - -<a name="Hyperlinks"></a> - <a name="How+to+read+hyperlinks+from+a+slide+show"></a> -<div class="h2"> -<h2>How to read hyperlinks from a slide show<a title="Permanent link" class="headerlink" href="#How+to+read+hyperlinks+from+a+slide+show">#</a> -</h2> -</div> - +<a name="Hyperlinks" id="Hyperlinks"></a><a name="How+to+read+hyperlinks+from+a+slide+show"></a> +<h4>How to read hyperlinks from a slide show</h4> <pre class="code"> FileInputStream is = new FileInputStream("slideshow.ppt"); HSLFSlideShow ppt = new HSLFSlideShow(is); @@ -623,15 +682,8 @@ if (VERSION > 3) { } } </pre> - - -<a name="Tables"></a> - <a name="How+to+create+tables"></a> -<div class="h2"> -<h2>How to create tables<a title="Permanent link" class="headerlink" href="#How+to+create+tables">#</a> -</h2> -</div> - +<a name="Tables" id="Tables"></a><a name="How+to+create+tables"></a> +<h4>How to create tables</h4> <pre class="code"> //table data String[][] data = { @@ -679,16 +731,8 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - - - -<a name="RemoveShape"></a> - <a name="How+to+remove+shapes+from+a+slide"></a> -<div class="h2"> -<h2>How to remove shapes from a slide<a title="Permanent link" class="headerlink" href="#How+to+remove+shapes+from+a+slide">#</a> -</h2> -</div> - +<a name="RemoveShape" id="RemoveShape"></a><a name="How+to+remove+shapes+from+a+slide"></a> +<h4>How to remove shapes from a slide</h4> <pre class="code"> for (HSLFShape shape : slide.getShapes()) { // remove the shape @@ -698,15 +742,8 @@ if (VERSION > 3) { } } </pre> - - -<a name="OLE"></a> - <a name="How+to+retrieve+embedded+OLE+objects"></a> -<div class="h2"> -<h2>How to retrieve embedded OLE objects<a title="Permanent link" class="headerlink" href="#How+to+retrieve+embedded+OLE+objects">#</a> -</h2> -</div> - +<a name="OLE" id="OLE"></a><a name="How+to+retrieve+embedded+OLE+objects"></a> +<h4>How to retrieve embedded OLE objects</h4> <pre class="code"> for (HSLFShape shape : slide.getShapes()) { if (shape instanceof OLEShape) { @@ -721,16 +758,8 @@ if (VERSION > 3) { } } </pre> - - - -<a name="Sound"></a> - <a name="How+to+retrieve+embedded+sounds"></a> -<div class="h2"> -<h2>How to retrieve embedded sounds<a title="Permanent link" class="headerlink" href="#How+to+retrieve+embedded+sounds">#</a> -</h2> -</div> - +<a name="Sound" id="Sound"></a><a name="How+to+retrieve+embedded+sounds"></a> +<h4>How to retrieve embedded sounds</h4> <pre class="code"> FileInputStream is = new FileInputStream(args[0]); HSLFSlideShow ppt = new HSLFSlideShow(is); @@ -745,16 +774,8 @@ if (VERSION > 3) { } } </pre> - - - -<a name="Freeform"></a> - <a name="How+to+create+shapes+of+arbitrary+geometry"></a> -<div class="h2"> -<h2>How to create shapes of arbitrary geometry<a title="Permanent link" class="headerlink" href="#How+to+create+shapes+of+arbitrary+geometry">#</a> -</h2> -</div> - +<a name="Freeform" id="Freeform"></a><a name="How+to+create+shapes+of+arbitrary+geometry"></a> +<h4>How to create shapes of arbitrary geometry</h4> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); HSLFSlide slide = ppt.createSlide(); @@ -771,24 +792,15 @@ if (VERSION > 3) { shape.setPath(path); slide.addShape(shape); </pre> - - - -<a name="Graphics2D"></a> - <a name="How+to+draw+into+a+slide+using+Graphics2D"></a> -<div class="h2"> -<h2>How to draw into a slide using Graphics2D<a title="Permanent link" class="headerlink" href="#How+to+draw+into+a+slide+using+Graphics2D">#</a> -</h2> -</div> - -<div class="frame warning"> +<a name="Graphics2D" id="Graphics2D"></a><a name="How+to+draw+into+a+slide+using+Graphics2D"></a> +<h4>How to draw into a slide using Graphics2D</h4> +<div class="warning"> <div class="label">Warning</div> <div class="content"> Current implementation of the PowerPoint Graphics2D driver is not fully compliant with the java.awt.Graphics2D specification. Some features like clipping, drawing of images are not yet supported. </div> </div> - <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); HSLFSlide slide = ppt.createSlide(); @@ -840,22 +852,13 @@ if (VERSION > 3) { ppt.write(out); out.close(); </pre> - - - -<a name="Render"></a> - <a name="Export+PowerPoint+slides+into+java.awt.Graphics2D"></a> -<div class="h2"> -<h2>Export PowerPoint slides into java.awt.Graphics2D<a title="Permanent link" class="headerlink" href="#Export+PowerPoint+slides+into+java.awt.Graphics2D">#</a> -</h2> -</div> - +<a name="Render" id="Render"></a><a name="Export+PowerPoint+slides+into+java.awt.Graphics2D"></a> +<h4>Export PowerPoint slides into java.awt.Graphics2D</h4> <p> HSLF provides a way to export slides into images. You can capture slides into java.awt.Graphics2D object (or any other) and serialize it into a PNG or JPEG format. Please note, although HSLF attempts to render slides as close to PowerPoint as possible, the output may look differently from PowerPoint due to the following reasons: </p> - <ul> <li>Java2D renders fonts differently vs PowerPoint. There are always some differences in the way the font glyphs are painted</li> @@ -865,11 +868,9 @@ if (VERSION > 3) { <li>If a font from the presentation is not available, then the JDK default font will be used.</li> </ul> - <p> Current Limitations: </p> - <ul> <li>Some types of shapes are not yet supported (WordArt, complex auto-shapes)</li> @@ -877,7 +878,6 @@ if (VERSION > 3) { <li>Only Bitmap images (PNG, JPEG, DIB) can be rendered in Java</li> </ul> - <pre class="code"> FileInputStream is = new FileInputStream("slideshow.ppt"); HSLFSlideShow ppt = new HSLFSlideShow(is); @@ -905,17 +905,8 @@ if (VERSION > 3) { idx++; } </pre> - - - - -<a name="HeadersFooters"></a> - <a name="How+to+extract+Headers+%2F+Footers+from+an+existing+presentation"></a> -<div class="h4"> -<h4>How to extract Headers / Footers from an existing presentation<a title="Permanent link" class="headerlink" href="#How+to+extract+Headers+%2F+Footers+from+an+existing+presentation">#</a> -</h4> -</div> - +<a name="HeadersFooters" id="HeadersFooters"></a><a name="How+to+extract+Headers+%2F+Footers+from+an+existing+presentation"></a> +<h3 class="boxed">How to extract Headers / Footers from an existing presentation</h3> <pre class="code"> FileInputStream is = new FileInputStream("slideshow.ppt"); HSLFSlideShow ppt = new HSLFSlideShow(is); @@ -941,14 +932,8 @@ if (VERSION > 3) { } } </pre> - - <a name="How+to+set+Headers+%2F+Footers"></a> -<div class="h4"> -<h4>How to set Headers / Footers<a title="Permanent link" class="headerlink" href="#How+to+set+Headers+%2F+Footers">#</a> -</h4> -</div> - +<h3 class="boxed">How to set Headers / Footers</h3> <pre class="code"> HSLFSlideShow ppt = new HSLFSlideShow(); @@ -957,51 +942,37 @@ if (VERSION > 3) { hdd.setSlideNumberVisible(true); hdd.setFootersText("Created by POI-HSLF"); </pre> - - - - -<div id="authors" align="right">by Yegor Kozlov</div> -</div> </div> + +<p align="right"> +<font size="-2">by Yegor Kozlov</font> +</p> +</div> +<!--+ + |end content + +--> +<div class="clearboth"> </div> </div> -</td> -<!--================= end Content ==================--> -</tr> -</tbody> -</table> -<!--================= end Main ==================--> -<!--================= start Footer ==================--> <div id="footer"> -<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0"> -<tbody> -<tr> -<!--================= start Copyright ==================--> -<td colspan="2"> -<div align="center"> +<!--+ + |start bottomstrip + +--> +<div class="lastmodified"> +<script type="text/javascript"><!-- +document.write("Last Published: " + document.lastModified); +// --></script> +</div> <div class="copyright"> - Copyright © 2002-2018 The Apache Software Foundation. All rights reserved.<br> - Apache, Apache POI, and the Apache POI logo are registered trademarks or - trademarks of The Apache Software Foundation in the U.S. and/or other countries. - </div> -</div> -</td> -<!--================= end Copyright ==================--> -</tr> -<tr> -<td align="left"> -<!--================= start Host ==================--> -<!--================= end Host ==================--></td><td align="right"> -<!--================= start Credits ==================--> -<div align="right"> -<div class="credit"></div> -</div> -<!--================= end Credits ==================--> -</td> -</tr> -</tbody> -</table> + Copyright © + 2001-2018 <a href="https://www.apache.org/">The Apache Software Foundation</a> +</div> +<div id="feedback"> + Send feedback about the website to: + <a id="feedbackto" href="mailto:[email protected]?subject=Feedback%C2%A0components/slideshow/how-to-shapes.html">[email protected]</a> +</div> +<!--+ + |end bottomstrip + +--> </div> -<!--================= end Footer ==================--> </body> </html> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
