[HideViewOnScrollBehavior] Add a method to get the HideViewOnScrollBehavior associated with the view

Resolves #4768

GIT_ORIGIN_REV_ID=9471abba29b6c63aaeadf6cb4708480e8e8cc0b8
PiperOrigin-RevId: 757874866

Author: pubiqq

lib/java/com/google/android/material/behavior/HideViewOnScrollBehavior.java

@@ -421,4 +421,26 @@ public void disableOnTouchExploration(boolean disableOnTouchExploration) {
   public boolean isDisabledOnTouchExploration() {
     return disableOnTouchExploration;
   }
+
+  /**
+   * A utility function to get the {@link HideViewOnScrollBehavior} associated with the {@code
+   * view}.
+   *
+   * @param view The {@link View} with {@link HideViewOnScrollBehavior}.
+   * @return The {@link HideViewOnScrollBehavior} associated with the {@code view}.
+   */
+  @NonNull
+  @SuppressWarnings("unchecked")
+  public static <V extends View> HideViewOnScrollBehavior<V> from(@NonNull V view) {
+    ViewGroup.LayoutParams params = view.getLayoutParams();
+    if (!(params instanceof LayoutParams)) {
+      throw new IllegalArgumentException("The view is not a child of CoordinatorLayout");
+    }
+    CoordinatorLayout.Behavior<?> behavior = ((LayoutParams) params).getBehavior();
+    if (!(behavior instanceof HideViewOnScrollBehavior)) {
+      throw new IllegalArgumentException(
+          "The view is not associated with HideViewOnScrollBehavior");
+    }
+    return (HideViewOnScrollBehavior<V>) behavior;
+  }
 }