FPDFAnnot_IsChecked API for checkboxes and radio buttons.

Part of feature work to make PDFium more usable by mobile platforms
that need to provide accessibility labels that reflect the state of the
widget.

R=thestig@chromium.org

Bug: b/135921512
Change-Id: I4f6d79335c0d29a592202577a2c238b6a110d98f
Reviewed-on: https://pdfium-review.googlesource.com/c/pdfium/+/56870
Commit-Queue: Lei Zhang <thestig@chromium.org>
Reviewed-by: Lei Zhang <thestig@chromium.org>
diff --git a/public/fpdf_annot.h b/public/fpdf_annot.h
index ee81ae8..e6e7765 100644
--- a/public/fpdf_annot.h
+++ b/public/fpdf_annot.h
@@ -608,6 +608,18 @@
                       FPDF_ANNOTATION annot,
                       float* value);
 
+// Experimental API.
+// Determine if |annot| is a form widget that is checked. Intended for use with
+// checkbox and radio button widgets.
+//
+//   hHandle - handle to the form fill module, returned by
+//             FPDFDOC_InitFormFillEnvironment.
+//   annot   - handle to an annotation.
+//
+// Returns true if |annot| is a form widget and is checked, false otherwise.
+FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_IsChecked(FPDF_FORMHANDLE hHandle,
+                                                        FPDF_ANNOTATION annot);
+
 #ifdef __cplusplus
 }  // extern "C"
 #endif  // __cplusplus