wiki:FRAME_PROPERTY_LOCKING_R0
Last modified 16 years ago Last modified on 01/15/09 18:48:36

Error: Macro BackLinksMenu(None) failed
compressed data is corrupt

Error: Macro TicketQuery(summary=FRAME_PROPERTY_LOCKING_R0, format=table, col=summary|owner|status|type|component|priority|effort|importance, rows=description|analysis_owners|analysis_reviewers|analysis_score|design_owners|design_reviewers|design_score|implementation_owners|implementation_reviewers|implementation_score|test_owners|test_reviewers|test_score|) failed
current transaction is aborted, commands ignored until end of transaction block

Analysis

Overview

Frame property locking provides the ability a property to be protected from changing. Frame property locking should be presented to the user as a checkbox in the Frame hud. When the checkbox is checked for a property, it's value will not be changeable until it's checkbox is unchecked.

Task requirements

Provide a prototype of frame property locking. Locking should be available for frame:

  • content
  • insets
  • bounds
  • border style
  • background style
  • shadow style

Providing locking for these is enough for this revision. In later revisions, they may be split into sub-elements (border style - border thickness, border color, etc).

Task result

The result of this task must be code.

Implementation idea

Create a value property

  • contentLock
  • insetsLock
  • boundsLock
  • borderLock
  • backgroundLock
  • shadowLock

at the Frame class.

FRAME_TEMPLATES_R0

How to demo

  • Create a frame.
  • Lock the border.
  • Change border width.
  • Assert that border width is the same.

Design

  • In the TemplateField class in org.sophie2.base.model module add property boolean value property locked which will provide if property could be changed. If the value of this property locked() is true, then the value of property could not be changed.
  • Create method setOwnValue(T value) which will set value of the own property depending on if locked() is true or false.
  • Add boolean value property contentLock() in Frame class that will provide if the content of the Frame is locked.
  • Add setFrameContent(FrameContent content) method that will sets the own content of the frame depending on whether locked property is true or false.
  • org.sophie2.base.model.book.FramePropertyLockingTest is a test for frame properties locking.

Implementation

(Implementation results should be described and linked here (from the wiki or the repository))

Testing

Comments

  • The current situation with properties is as follow:
    • Frame
      • RwProp<Page> parent()
      • Prop<UUID> id() (final)
      • Prop<ShadowStyle> shadow() (auto, @own)
        • RwProp<ImmPoint> position()
        • RwProp<Color> color()
        • RwProp<Double> opacity()
        • RwProp<Boolean> enabled()
      • RwProp<Integer> zOrder() (auto)
      • RwProp<FrameContent> content() (value, own)
      • RwProp<Frame> template() (value)
      • RwProp<ImmSize> size() (value)
      • RwProp<ImmPoint> location() (value)
      • RwProp<ImmRect> bounds() (value)
      • Prop<BorderStyle> border() (auto)
        • RwProp<Integer> borderThickness()
        • RwProp<Color> borderColor()
      • Prop<BackgroundStyle> background()
        • RwProp<BackgroundType> bgType()
        • RwProp<Color> bgColor()
        • RwProp<ImageBookResource> bgImageResource()
        • RwProp<Double> bgOpacity()
        • RwProp<MultipleGradientPaint> bgGradient()
      • Prop<ColorProps> borderColor()
        • RwProp<Color> color()
        • RwProp<Float> transparency()
      • RwProp<ColorProps> ownBorderColor()
      • RwProp<Boolean> borderColorLock()
      • RwProp<Insets> borderInsets() -> Prop (auto, @own)
        • RwProp<Float> top()
        • RwProp<Float> left()
        • RwProp<Float> bottom()
        • RwProp<Float> right()
      • RwProp<Insets> ownBorderInsets()
      • RwProp<Boolean> borderInsetsLock()
      • RwProp<Insets> paddingInsets()
      • RwProp<Insets> marginsInsets()
      • RwProp<ImmSize> sizeTodo()
      • RwProp<ImmPoint> locationTodo()
      • RwProp<ImmRect> boundsTodo()