RE: need help to insert an image with a caption with the Libo java API <text:sequence-ref instead of <text:sequence

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 <vincent.lorenzo@cea.fr> 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 <andrew@pitonyak.org>
Envoyé : jeudi 5 septembre 2019 22:57
À : LORENZO Vincent <vincent.lorenzo@cea.fr>
Cc : Kaganski Mike <mikekaganski@hotmail.com>; Miklos Vajna <vmiklos@collabora.com>; sos 
<sos@pmg.be>; libreoffice@lists.freedesktop.org
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 <vincent.lorenzo@cea.fr> 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 <libreoffice-bounces@lists.freedesktop.org> De la part de LORENZO Vincent
Envoyé : vendredi 15 février 2019 14:37
À : Kaganski Mike <mikekaganski@hotmail.com>; Miklos Vajna <vmiklos@collabora.com>; sos <sos@pmg.be>
Cc : libreoffice@lists.freedesktop.org
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:mikekaganski@hotmail.com]
Envoyé : mercredi 13 février 2019 11:42
À : Miklos Vajna <vmiklos@collabora.com>; LORENZO Vincent <vincent.lorenzo@cea.fr>
Cc : libreoffice@lists.freedesktop.org
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 <vincent.lorenzo@cea.fr> 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
LibreOffice@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice