Annotations style editor in Android

AnnotStyleDialogFragment is a DialogFragment that shows annotation style properties in a bottom sheet view. With this style dialog, users can change the annotation color with the advanced color picker or directly select preset styles. The style dialog also provides a recent and a favorite list for quick access.

To learn about customizing style dialog, see the customize style dialog guide .

Show an annotation style dialog

The AnnotationStyleDialogFragment.Builder class allows you to create an AnnotStyleDialogFragment with a specified AnnotStyle. The AnnotStyle represents the initial annotation style to display.

Example

Java

// 1. Instantiate an AnnotStyle with its constructor
AnnotStyle annotStyle = new AnnotStyle();
// 2. Set annotation type to annot style
annotStyle.setAnnotType(Annot.e_Square);
// 3. Set blue stroke, yellow fill color, thickness 5, opacity 0.8 to the annotation style.
annotStyle.setStyle(Color.BLUE, Color.YELLOW, 5f, 0.8f);
// 4. Instantiate an AnnotStyleDialogFragment.Builder with its constructor
AnnotStyleDialogFragment.Builder styleDialogBuilder = new AnnotStyleDialogFragment.Builder(annotStyle);
// 5. Set anchor view if you want the `AnnotStyleDialogFragment` be displayed as a popup window in tablet mode
styleDialogBuilder.setAnchorView(myButton);
// 6. Build AnnotStyleDialogFragment with the arguments supplied to this builder.
AnnotStyleDialogFragment annotStyleDialog = styleDialogBuilder.build();

Kotlin

// 1. Instantiate an AnnotStyle with its constructor
val annotStyle = AnnotStyle()
// 2. Set annotation type to annot style
annotStyle.annotType = Annot.e_Square
// 3. Set blue stroke, yellow fill color, thickness 5, opacity 0.8 to the annotation style.
annotStyle.setStyle(Color.BLUE, Color.YELLOW, 5f, 0.8f)
// 4. Instantiate an AnnotStyleDialogFragment.Builder with its constructor
val styleDialogBuilder = AnnotStyleDialogFragment.Builder(annotStyle)
// 5. Set anchor view if you want the `AnnotStyleDialogFragment` be displayed as a popup window in tablet mode
styleDialogBuilder.setAnchorView(myButton)
// 6. Build AnnotStyleDialogFragment with the arguments supplied to this builder.
val annotStyleDialog = styleDialogBuilder.build()

Afterwards, to show an annotation style dialog call show(FragmentManager). Similarly, to dismiss the annotation style dialog programmatically call dismiss().

Listen to annotation style changes

You can listen to annotation style changes by setting an OnAnnotStyleChangeListener to your AnnotStyleDialogFragment using setOnAnnotStyleChangeListener. The AnnotStyleDialogFragment raises an event when a style change occurs (such as a color change, thickness change, text color change, etc., allowing you to define custom behavior for such events.

To learn about changing annotation style, see the change annotation properties guide.