I am going from memory here, so I might be a bit off.
When you create a variable such as "Figure", it is of a specific type because
they know how you want to use it. If I insert a caption manually, something
like the following happens.
I enter the text "Figure " at the start of a paragraph and then I insert a
field; one of those Figure fields (The type is SetExpression). I then set the
value to be "Figure + 1". It turns out that we have a single MASTER for ALL of
the Figure fields that you see. They are ALL a dependent, child, or what ever
they call it, of this one master text field. In OOME.odt (on my web site), I
have examples in Basic to create and manipulate these, but it is missing some
details I think.
I thought that you wanted to know how to insert a reference to a specific
SetExpression field, which is the part that says something like "Figure 1.
...". I was wrong. So, I assume that you want to insert one of those
SetExpression fields (A caption field).
Lets consider what happens when I insert a caption using the UI. Note that I
don't really know what it does, but, I am guessing and going from memory. So,
some of my details may be wrong.
I paste a graphic into my document. By default, I think that it anchors itself
to a paragraph and it can float a bit, but that is not very important for our
purposes. This is my best guess as to what happens when you right click and say
create caption.
1. A frame is created that uses the same anchor as the graphic.
2. The graphic is anchored as a character to the text object in the frame as a
character.
3. The text "Figure " is inserted followed by a SetExpression type field with
the expression "Figure + 1" followed by the rest of your text.
So, I think that by default there is a single paragraph in that text frame. I
could not tell you how things are sized because I have never looked into it,
but, that is how I think it is done. What ever they do, if you resize the
frame, the image resizes with it. In other words, i think that they probably
set some specific properties on the image and on the frame for that magic to
occur.
Let me look again at what you say you want to do..
You insert an image and you know how to do that. Good.
I think you then say that you do not know how to create a caption for that
image, but you use the term "Table Of Figure" so I think of creating a list of
references to figures, which would really reference those SetExpression fields
(I think that text field type is called a GetExpression). So I think you want
to know how to insert a SetExpression field.
Also not that you are referencing the text field, which is associated to a
graphic (or what ever) based on proximity (it is close).
The first question you must ask.... Does your Master text field already exist?
You can create your own if you want, so, you could four different types of
figures with their own Master field.
OOME (OpenOffice Macros Explained) demonstrates how to create a Master Field if
you need to. You are probably using one that already exists, however. The
example below creates one named "Listing".
A Listing sequence field is associated to the
com.sun.star.text.FieldMaster.SetExpression.Listing master field, which must
exist before the sequence field can be used. Listing 396 Demonstrates how to
create a master field if it does not exist, and how to get the master field if
it does.
Listing 396. Creating a master field.
oMasters = oDoc.getTextFieldMasters
If NOT
oMasters.hasByName("com.sun.star.text.FieldMaster.SetExpression.Listing") Then
oMasterField =
oDoc.createInstance("com.sun.star.text.FieldMaster.SetExpression")
oMasterField.Name = "Listing"
oMasterField.SubType = com.sun.star.text.SetVariableType.SEQUENCE
Else
oMasterField =
oMasters.getByName("com.sun.star.text.FieldMaster.SetExpression.Listing")
End If
The master field sub-type determines the field type (see Table 154).
Table 154. Constants for
com.sun.star.text.SetVariableType.ValueConstantDescription0com.sun.star.text.SetVariableType.VAR
Simple variable. 1com.sun.star.text.SetVariableType.SEQUENCE Number sequence
field. 2com.sun.star.text.SetVariableType.FORMULA Formula field.
3com.sun.star.text.SetVariableType.STRING String field.
This is the next section:
The sequence field is created by the document, then the numbering type is set
to arabic. The number format is set, the master field is associated to the
field (the master field is a sequence field), and then the field content is set
to increment the value (Listing + 1). Note that when the field is inserted, the
field may not be immediately updated. Either wait for the field to update, or
force an update using Tools > Update > Fields.
Listing 397. Creating a set expression sequence field.
oField = oDoc.createInstance("com.sun.star.text.TextField.SetExpression")
oField.NumberingType = com.sun.star.style.NumberingType.ARABIC
oField.NumberFormat = FindCreateNumberFormatStyle("###0", oDoc)
oField.attachTextFieldMaster(oMasterField)
oField.Content = name & " + 1"
Constants used to set the numbering type are set as shown in the Table 150.
Things to note.
1. The document creates field that you want to insert.
2. The SetExpression field itself is directly attached to the associated Master
field (attachTextFieldMaster).
3. I actually create my own numbering style, I don't know what the default is
or what happens if you do not set the style. I just don't remember.
4. This little snippet does not actually show you inserting the field. You do
this by inserting text content with a text cursor.
5. You will not see anything displayed, at least not correctly, until after you
update fields from the menu. In the example I posted, i used a dispatch to do
this for you.
There is a full example that replaces text references for figures with actual
fields such as this. I had a document with a bunch of manually entered values
and I wanted to use fields. It was created before I knew how to do that using
the UI.
So, I hope this helps some.
I am overdue for pushing a new copy of OOME4.odt; I made some changes in other
areas, I just need to push it.
On Friday, September 06, 2019 09:51 EDT, LORENZO Vincent
<[email protected]> wrote:
Hi Andrew,
Thank you for your answer. In fact I want to create a numbered caption
(something like « Figure 1 : my nice caption ») under an inserted image and I
want to create a table of figure with these captions to list all images.
- The image is well inserted
- The Table Of Figure is created and works fine when I add manually an
image with a caption in the generated document.
- This table of Figure doesn’t work for the image inserted
programmatically, probably, because I don’t know how to create properly a
numbered caption.
I’m a bit confused about the SetExpression, DependentField, field master, … I
will continue to investigate about that, but if you have some references for
me, please don’t hesitate.
Regards,
/Vincent Lorenzo
De : Andrew Pitonyak <[email protected]>
Envoyé : jeudi 5 septembre 2019 22:57
À : LORENZO Vincent <[email protected]>
Cc : Kaganski Mike <[email protected]>; Miklos Vajna
<[email protected]>; sos <[email protected]>; [email protected]
Objet : RE: need help to insert an image with a caption with the Libo java API
<text:sequence-ref instead of <text:sequence
Are you looking to insert the caption, or the reference to the caption? I think
you want to insert a reference to a dependent field for a text field master.
Does this sound correct?
The text field master, which is of type:
com.sun.star.text.fieldmaster.SetExpression.Figure
But you want to reference a Dependent field. If my guess is correct, this is
how I insert a reference to the first Figure using Basic. Note that there is
almost no error checking, so, this could go very wrong.
Sub Main
Dim oField
Dim oNewField
Dim oText
Dim oCurs
Dim oReferencedField
Dim oEnum
Dim oDispatcher ' Dispatcher object.
Dim oFrame
' Setup to perform a dispatch.
oFrame = ThisComponent.CurrentController.Frame
oDispatcher = createUnoService("com.sun.star.frame.DispatchHelper")
oText = ThisComponent.getText()
oCurs = ThisComponent.CurrentController.getViewCursor()
oEnum = ThisComponent.getTextFields().createEnumeration()
If Not IsNull(oEnum) Then
Do While oEnum.hasMoreElements()
oField = oEnum.nextElement()
'Inspect oField
If oField.supportsService("com.sun.star.text.TextField.SetExpression")
Then
If oField.VariableName = "Figure" Then
Print "Found one"
Exit Do
End If
End If
Loop
End If
' No error checking, I just assume that I found one. DANGER DANGER DANGER
oNewField =
ThisComponent.createInstance("com.sun.star.text.textfield.GetReference")
oNewField.ReferenceFieldPart =
com.sun.star.text.ReferenceFieldPart.CATEGORY_AND_NUMBER
oNewField.ReferenceFieldSource =
com.sun.star.text.ReferenceFieldSource.SEQUENCE_FIELD
oNewField.SequenceNumber = oField.SequenceValue
oNewField.SourceName = "Figure"
oText.insertTextContent(oCurs, oNewField, True)
' This next part will NOT work until after all of the fields have updated.
' So, force an update.
oDispatcher.executeDispatch(oFrame, ".uno:UpdateFields", "", 0, Array())
End Sub
On Thursday, September 05, 2019 10:59 EDT, LORENZO Vincent
<[email protected]> wrote:
Hello everybody,
Since my last question, I switched task. Now I come back to my LibreOffice task
to resolve my caption problem.
I'm still blocked on this problem. I get a different result compared to my last
email, but the reference for the caption is still not found.
I replace Illustration by Figure, but the problem keeps the same.
I obtain a text:sequence-ref instead of a text:sequence. Does someone know why
or which is the API to use to generate a text:sequence...
My result for the numbering of the caption:
<text:sequence-ref text:reference-format="value"
text:ref-name="refFigure0">Erreur : source de la référence non
trouvée</text:sequence-ref> (the french text said "reference not found")
I would like to get :
<text:sequence text:ref-name="refFigure0" text:name="Figure"
text:formula="ooow:Figure+1" style:num-format="1">1</text:sequence>
My java code for that :
Object oReference =
xMultiServiceFactory.createInstance("com.sun.star.text.textfield.GetReference");
XPropertySet oReferencePropertySet =
UnoRuntime.queryInterface(XPropertySet.class, oReference);
oReferencePropertySet.setPropertyValue("SourceName", "Figure");// I get
<text:sequence-ref
oReferencePropertySet.setPropertyValue("ReferenceFieldPart",
ReferenceFieldPart.ONLY_SEQUENCE_NUMBER);
oReferencePropertySet.setPropertyValue("ReferenceFieldSource",
ReferenceFieldSource.SEQUENCE_FIELD);
oReferencePropertySet.setPropertyValue("SequenceNumber", 0);// (short) 2);//not
requireed ?
XTextContent xRef = UnoRuntime.queryInterface(XTextContent.class, oReference);
localCursor.getText().insertTextContent(localCursor, xRef, false);
Regards,
--
Vincent Lorenzo
-----Message d'origine-----
De : LibreOffice <[email protected]> De la part de
LORENZO Vincent
Envoyé : vendredi 15 février 2019 14:37
À : Kaganski Mike <[email protected]>; Miklos Vajna
<[email protected]>; sos <[email protected]>
Cc : [email protected]
Objet : [PROVENANCE INTERNET] RE: need help to insert an image with a caption
with the Libo java API
Hello everybody,
I thank you for your answers. Yes I want to add an image with a caption
programmatically and I want a caption like this "Illustration 1 : My caption"
To my mind, it would be better/cleaner if I was able to generate the same thing
than I do the UI. Thanks to you, I succeed to build the expected structure for
the image and to set a text below it, but I still have some problems, mainly
with the GetReference.
The GetReference generates :
<text:reference-ref text:reference-format="text"
text:ref-name="refIllustration0">Erreur : source de la référence non
trouvée</text:reference-ref> (sorry my Libo is in French, it is written "Sorry
: source of the reference not found").
And I would like to get a text:sequence instead of a text:reference, to get
this result:
<text:sequence text:ref-name="refIllustration0" text:name="Illustration"
text:formula="ooow:Illustration+1" style:num-format="1">1</text:sequence>
Please, do you know how I can build a text:sequence ?
Please found in attachment the java code I wrote [1], the expect xml structure
[2] and the current xml structure [3].
I know I have some difference between [2] and [3] with the width/height
properties and inside the draw frame, but it is not the subject of this thread.
[1] insertImage.java
[2] expectedResult.xml
[3] currentResult.xml
In addition, I have more generic question, do you know if it exists a
documentation, indicating mapping, between the xml elements and how to
get/create them from java ? For example, in xml svg:width is called Height in
the java API, and my Textframe becomes <draw:text-box...<
Best regards,
--
Vincent Lorenzo
-----Message d'origine-----
De : Kaganski Mike [mailto:[email protected]]
Envoyé : mercredi 13 février 2019 11:42
À : Miklos Vajna <[email protected]>; LORENZO Vincent
<[email protected]>
Cc : [email protected]
Objet : Re: need help to insert an image with a caption with the Libo java API
On 13.02.2019 12:45, Miklos Vajna via LibreOffice wrote:
> Hi,
>
> On Tue, Feb 12, 2019 at 09:27:15AM +0000, LORENZO Vincent
> <[email protected]> wrote:
>> I would like to add a caption, to an inserted image in a text
>> document, but I don't find how to do that... Please do you have
>> pointer/documentation for me ?
>
> I think captions are just a UI feature. The doc model just stores a
> text frame around the image and the image is followed by the caption itself.
>
> (I.e. later it's not possible to reliably detect if some content
> around an image in a frame was created by hand or using the captions
> UI code.)
>
> So you can do the same "manually" using the UNO API. When in doubt,
> see what UNO API the ODT import uses to create the doc model based on
> the input markup.
And actually, if an image is not intended to be floating, but (as seen in
majority of cases) is a part of normal text flow, then the frame could be not
needed at all - simply add an image anchored as character, then add a paragraph
with required style and numbering range field, then continue with other
paragraphs. This makes the document structure clearer. Just an advise based on
own experience.
--
Best regards,
Mike Kaganski
_______________________________________________
LibreOffice mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/libreoffice
_______________________________________________
LibreOffice mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/libreoffice
