Few documentation updates for recent new code

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@685263 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Nick Burch 2008-08-12 18:55:47 +00:00
parent 0f5af26377
commit f2d371df00
2 changed files with 20 additions and 2 deletions

View File

@ -92,6 +92,12 @@
properties. Chances are that you will find here what you need and don't properties. Chances are that you will find here what you need and don't
have to read the other sections.</note> have to read the other sections.</note>
<p>If all you are interested in is getting the textual content of
all the document properties, such as for full text indexing, then
take a look at
<code>org.apache.poi.hpsf.extractor.HPFSPropertiesExtractor</code>. However,
if you want full access to the properties, please read on!</p>
<p>The first thing you should understand is that a Microsoft Office file is <p>The first thing you should understand is that a Microsoft Office file is
not one large bunch of bytes but has an internal filesystem structure with not one large bunch of bytes but has an internal filesystem structure with
files and directories. You can access these files and directories using files and directories. You can access these files and directories using

View File

@ -55,13 +55,25 @@ can then get text and other properties.
</p> </p>
</section> </section>
<section><title>Headers and Footers</title>
<p>To get at the headers and footers of a word document, first create a
<code>org.apache.poi.hwpf.HWPFDocument</code>. Next, you need to create a
<code>org.apache.poi.hwpf.usermodel.HeaderStores</code>, passing it your
HWPFDocument. Finally, the HeaderStores gives you access to the headers and
footers, including first / even / odd page ones if defined in your
document. Additionally, HeaderStores provides a method for removing
any macros in the text, which is helpful as many headers and footers
do end up with macros in them.</p>
</section>
<section><title>Changing Text</title> <section><title>Changing Text</title>
<p>It is possible to change the text via <p>It is possible to change the text via
<code>insertBefore()</code> and <code>insertAfter()</code> <code>insertBefore()</code> and <code>insertAfter()</code>
on a <code>Range</code> object (either a <code>Range</code>, on a <code>Range</code> object (either a <code>Range</code>,
<code>Paragraph</code> or <code>CharacterRun</code>). <code>Paragraph</code> or <code>CharacterRun</code>).
It is also possible to delete a <code>Range</code>, but this It is also possible to delete a <code>Range</code>.
code is know to have bugs in it. This code will work in many, but not all cases, and patches to
improve it are gratefully received!
</p> </p>
</section> </section>