-
- All Implemented Interfaces:
-
android.content.ComponentCallbacks,android.view.View.OnCreateContextMenuListener,androidx.activity.result.ActivityResultCaller,androidx.lifecycle.HasDefaultViewModelProviderFactory,androidx.lifecycle.LifecycleOwner,androidx.lifecycle.ViewModelStoreOwner,androidx.savedstate.SavedStateRegistryOwner,net.gini.android.capture.analysis.AnalysisFragmentInterface,net.gini.android.capture.internal.ui.FragmentImplCallback
public class AnalysisFragmentCompat extends Fragment implements FragmentImplCallback, AnalysisFragmentInterface
When you use the Component API with the Android Support Library, the
AnalyzeDocumentFragmentCompatdisplays the captured or imported document and an activity indicator while the document is being analyzed by the Gini API.Note: You can use the activity indicator message to display a message under the activity indicator by overriding the string resource named
gc_analysis_activity_indicator_message. The message is displayed for images only.For PDF documents the first page is shown (only on Android 5.0 Lollipop and newer) along with the PDF's filename and number of pages above the page. On Android KitKat and older only the PDF's filename is shown with the preview area left empty.
Note: Your Activity hosting this Fragment must extend the and use an AppCompat Theme.
Include the
AnalyzeDocumentFragmentCompatinto your layout by using the createInstance factory method to create an instance and display it using the androidx.fragment.app.FragmentManager.An AnalysisFragmentListener instance must be available until the
AnalysisFragmentCompatis attached to an activity. Failing to do so will throw an exception. The listener instance can be provided either implicitly by making the hosting Activity implement the AnalysisFragmentListener interface or explicitly by setting the listener using setListener.Your Activity is automatically set as the listener in onCreate.
See the AnalysisActivity for details.
-
-
Field Summary
Fields Modifier and Type Field Description public StringmPreviousWho
-
Method Summary
Modifier and Type Method Description voidhideError()Call this method to hide the error shown before with showError or showError. voidonCreate(Bundle savedInstanceState)Internal use only. ViewonCreateView(LayoutInflater inflater, @Nullable() ViewGroup container, @Nullable() Bundle savedInstanceState)Internal use only. voidonDestroy()Internal use only. voidonStart()Internal use only. voidonStop()Internal use only. voidshowError(@NonNull() String message, @NonNull() String buttonTitle, @NonNull() View.OnClickListener onClickListener)Call this method when you need to show an error message with an invokable action to the user in the Analysis Screen. voidshowError(@NonNull() String message, int duration)Call this method when you need to show an error message to the user in the Analysis Screen. voidsetListener(@NonNull() AnalysisFragmentListener listener)Set a listener for analysis events. static AnalysisFragmentCompatcreateInstance(@NonNull() Document document, @Nullable() String documentAnalysisErrorMessage)Factory method for creating a new instance of the Fragment using the provided document. voidshowAlertDialog(@NonNull() String message, @NonNull() String positiveButtonTitle, @NonNull() DialogInterface.OnClickListener positiveButtonClickListener, @Nullable() String negativeButtonTitle, @Nullable() DialogInterface.OnClickListener negativeButtonClickListener, @Nullable() DialogInterface.OnCancelListener cancelListener)-
Methods inherited from class androidx.fragment.app.Fragment
dump, equals, getActivity, getAllowEnterTransitionOverlap, getAllowReturnTransitionOverlap, getArguments, getChildFragmentManager, getContext, getDefaultViewModelCreationExtras, getDefaultViewModelProviderFactory, getEnterTransition, getExitTransition, getFragmentManager, getHost, getId, getLayoutInflater, getLifecycle, getLoaderManager, getParentFragment, getParentFragmentManager, getReenterTransition, getResources, getRetainInstance, getReturnTransition, getSavedStateRegistry, getSharedElementEnterTransition, getSharedElementReturnTransition, getString, getTag, getTargetFragment, getTargetRequestCode, getText, getUserVisibleHint, getView, getViewLifecycleOwner, getViewLifecycleOwnerLiveData, getViewModelStore, hasOptionsMenu, hashCode, instantiate, isAdded, isDetached, isHidden, isInLayout, isMenuVisible, isRemoving, isResumed, isStateSaved, isVisible, onActivityCreated, onActivityResult, onAttach, onAttachFragment, onConfigurationChanged, onContextItemSelected, onCreateAnimation, onCreateAnimator, onCreateContextMenu, onCreateOptionsMenu, onDestroyOptionsMenu, onDestroyView, onDetach, onGetLayoutInflater, onHiddenChanged, onInflate, onLowMemory, onMultiWindowModeChanged, onOptionsItemSelected, onOptionsMenuClosed, onPause, onPictureInPictureModeChanged, onPrepareOptionsMenu, onPrimaryNavigationFragmentChanged, onRequestPermissionsResult, onResume, onSaveInstanceState, onViewCreated, onViewStateRestored, postponeEnterTransition, registerForActivityResult, registerForContextMenu, requestPermissions, requireActivity, requireArguments, requireContext, requireFragmentManager, requireHost, requireParentFragment, requireView, setAllowEnterTransitionOverlap, setAllowReturnTransitionOverlap, setArguments, setEnterSharedElementCallback, setEnterTransition, setExitSharedElementCallback, setExitTransition, setHasOptionsMenu, setInitialSavedState, setMenuVisibility, setReenterTransition, setRetainInstance, setReturnTransition, setSharedElementEnterTransition, setSharedElementReturnTransition, setTargetFragment, setUserVisibleHint, shouldShowRequestPermissionRationale, startActivity, startActivityForResult, startIntentSenderForResult, startPostponedEnterTransition, toString, unregisterForContextMenu -
Methods inherited from class net.gini.android.capture.internal.ui.FragmentImplCallback
getActivity, getView, startActivity, startActivityForResult -
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
-
Method Detail
-
hideError
void hideError()
-
onCreateView
@Nullable() View onCreateView(LayoutInflater inflater, @Nullable() ViewGroup container, @Nullable() Bundle savedInstanceState)
Internal use only.
-
onDestroy
void onDestroy()
Internal use only.
-
onStart
void onStart()
Internal use only.
-
onStop
void onStop()
Internal use only.
-
showError
void showError(@NonNull() String message, @NonNull() String buttonTitle, @NonNull() View.OnClickListener onClickListener)
Call this method when you need to show an error message with an invokable action to the user in the Analysis Screen.
- Parameters:
message- a short error messagebuttonTitle- if not null and not empty, shows a button with the given titleonClickListener- listener for the button
-
showError
void showError(@NonNull() String message, int duration)
Call this method when you need to show an error message to the user in the Analysis Screen.
- Parameters:
message- a short error messageduration- how long should the error message be shown in ms
-
setListener
void setListener(@NonNull() AnalysisFragmentListener listener)
Set a listener for analysis events.
By default the hosting Activity is expected to implement the AnalysisFragmentListener. In case that is not feasible you may set the listener using this method.
Note: the listener is expected to be available until the fragment is attached to an activity. Make sure to set the listener before that.
- Parameters:
listener- AnalysisFragmentListener instance
-
createInstance
static AnalysisFragmentCompat createInstance(@NonNull() Document document, @Nullable() String documentAnalysisErrorMessage)
Factory method for creating a new instance of the Fragment using the provided document.
You may pass in an optional analysis error message. This error message is shown to the user with a retry button.
Note: Always use this method to create new instances. Document is required and an exception is thrown if it's missing.
- Parameters:
document- must be the Document from (Document)documentAnalysisErrorMessage- an optional error message shown to the user
-
showAlertDialog
void showAlertDialog(@NonNull() String message, @NonNull() String positiveButtonTitle, @NonNull() DialogInterface.OnClickListener positiveButtonClickListener, @Nullable() String negativeButtonTitle, @Nullable() DialogInterface.OnClickListener negativeButtonClickListener, @Nullable() DialogInterface.OnCancelListener cancelListener)
-
-
-
-