office-gobmx/svx
Caolán McNamara 0b05a04f97 clarify what WantMouseEvent is for
and add tristate machine support that we also need

WantMouseEvent is if the first click in a browse cell that activates it should
be passed to the control that appears on click as if it was itself clicked on

primarily for the the CheckBoxController to toggle it immediately.
Rework to explicitly toggle the checkbox in that implementation rather than
rely on passing fake mouse click/release/tracking events.

seeing as the main dbaccess table design view doesn't auto-launch its listboxes
on clicking in a cell, but the sub create index dialog does, drop the auto-launch
in the index dialog to match the main table design rathern than add a feature
to weld::ComboBox to auto-launch the popup for that one solitary case

Change-Id: Ie3d3f2ecf55d3d5b0b02b85ca09a6ca64bb800e9
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/98603
Tested-by: Caolán McNamara <caolanm@redhat.com>
Reviewed-by: Caolán McNamara <caolanm@redhat.com>
2020-07-12 20:54:15 +02:00
..
doc
inc update pches 2020-07-12 12:20:05 +02:00
qa
sdi tdf#100772 sd: add uno:DeleteTable to non-NB menus 2020-07-07 22:21:26 +02:00
source clarify what WantMouseEvent is for 2020-07-12 20:54:15 +02:00
uiconfig/ui Add mobile version of find replace dialog 2020-07-08 12:54:16 +02:00
util svx: create instances with uno constructors 2020-07-08 17:41:36 +02:00
AllLangMoTarget_svx.mk
CppunitTest_svx_dialogs_test.mk
CppunitTest_svx_gallery_test.mk
CppunitTest_svx_unit.mk
Executable_gengal.mk
IwyuFilter_svx.yaml replace usage of blacklist with excludelist for IWYU 2020-07-10 02:03:40 +02:00
JunitTest_svx_unoapi.mk
Library_svx.mk reduce number of framework libraries 2020-07-04 16:56:59 +02:00
Library_svxcore.mk reduce number of framework libraries 2020-07-04 16:56:59 +02:00
Library_textconversiondlgs.mk svx: create instances with uno constructors 2020-07-08 17:41:36 +02:00
Makefile
Module_svx.mk
Package_gengal.mk
README
UIConfig_svx.mk Add mobile version of find replace dialog 2020-07-08 12:54:16 +02:00

Contains graphics related helper code. Lots of the draw and impress code is in this shared library.

xoutdev
this is where a lot of wht work would happen to move to the canvas. (what does that mean?)

svdraw
transparent gradient stuff. [seriously? surely much more, too]

== SdrObject ==

The shapes you can see in LibreOffice (like rectangle, etc.) are SdrObjects.
They are declared as a hierarchy:

SdrObject <- SdrAttrObj <- E3dObject <- E3dCompoundObject <- E3dCubeObj
    ^ ^ ^             ^            ^              | | ^ ^
    | | |             |            |              | | | +--- E3dExtrudeObj
    | | |             |            |              | | +----- E3dLatheObj
    | | |             |            |              | +------- E3dPolygonObj
    | | |             |            |              +--------- E3dSphereObj
    | | |             |            +--- E3dScene...
    | | |             |
    | | |             +--- SdrTextObj <- SdrObjCustomShape...
    | | |                   ^ ^ ^ ^ ^
    | | |                   | | | | +--- SdrEdgeObj...
    | | |                   | | | +----- SdrMeasureObj...
    | | |                   | | +------- SdrPathObj...
    | | |                   | +--------- SdrRectObj...
    | | |                   +----------- SdrTableObj...
    | | +--- SdrObjGroup...
    | + ---- SdrPageObj...
    +------- SdrVirtObj...

The above is incomplete of course.

== SdrModel / SdrView ==

Copied from svdview.hxx:

  First of all the app creates a SdrModel.
  Then it opens a Win and creates a SdrView.
  ShowSdrPage() announces a page at SdrView.
  It's possible to show SdrView in any Wins at once.

  SdrView can show as many Wins as it wants at once. Pages are announced
  or checked out with the help of ShowSdrPage()/HideSdrPage(). For every announced
  page there is a SdrPageView instance in container aPages. If more than one page
  is showed, you have to pay attention that the offset parameter of ShowSdrPage()
  is conformed to the size of the page (to prevent overlapping of two pages).

SdrView itself is inherited from many objects in a chain of inheritance (all
that starts with SdrPaintView - that is itself inherited from few classes
too):

SdrPaintView <- SdrSnapView <- SdrMarkView <- SdrEditView <- SdrPolyEditView
                                                                   ^
  +----------------------------------------------------------------+
  |
  SdrGlueEditView <- SdrObjEditView <- SdrExchangeView <- SdrDragView
                                                                   ^
  +----------------------------------------------------------------+
  |
  SdrCreateView <- SdrView

From SdrView on, it is not flat, but a real hierarchy again.

== Drawing Layer / SdrObject(s) ==

See drawinglayer/README for general information about drawinglayer.

Below is the class diagram that comes from
http://www.openoffice.org/marketing/ooocon2006/presentations/wednesday_g11.odp,
slide number 6.

.------- Model --------------.      .------- View -----------------------------------------.
| SdrObject - ViewContact    | 1..* | ViewObjectContact                                    |
|              getChild()    |------|    getPrimitiveList()  -----> Object(s) ---> SdrView |
|              getVOC()      |      |    getRecPrimitiveList()      Contact                |
|              getViewInd... |      |________|_____________________________________________|
| ...ependentPrimitiveList() |               |
|____________________________|            generates
                                             |           ______
                                             V          /      |
                                   .----------------------.    |
                                   | basePrimitive        |    |
                                   |   getRange()         |<---'
                                   |   getDecomposition() |
                                   |______________________|

For SdrObjects, there are own DrawingLayer primitives in
svx/source/sdr/primitive2d

The ViewContact / ViewObject / ViewObjectContact are in svx/source/sdr/contact
Decomposes the SdrObjects, and does all sort of operations on them.

If the number of visualizable objects (e.g. SdrObjects) is X, and the number of
SdrViews is Y, then:

- there are X ViewContact instances (1:1 relation with a visualizable object)
- there are Y ObjectContact instances (1:1 relation with an SdrView)
- there are X*Y ViewObjecContact instances (1:N relation to both
  visualizable objects and SdrViews)