ButtonDropin

Class Overview

This is the default UI class that you will have to drop into your layout XML to display a Button. It's important that you set a button ID in your layout XML, like show below. You find or create your button ID in the dashboard See Button for full instructions on how to initialize the SDK.

 <com.usebutton.sdk.ButtonDropin
           xmlns:button="http://schemas.android.com/apk/res-auto"
           android:layout_width="match_parent"
           android:layout_height="60dp"
           android:layout_margin="10dp"
           button:btn_buttonId="your-button-id"
           button:btn_textColor="@color/white"
           button:btn_textSize="18dp"
       />
 

Prepare Button with context.

    // Get the Button View
    final ButtonDropin buttonDropin = (ButtonDropin) findViewById(R.id.main_dropin);

   // Create a PlacementContext for the location you want a ride to. For this, let's assume a screen
   // showing our office location in NYC
   final ButtonContext context = ButtonContext.withSubjectLocation(new Location("Button HQ", 40.732561,-73.988068)));
   final userLocation = new LocationProvider(this).getBestLocation();
   if (userLocation != null) {
      context.setUserLocation(new Location(userLocation));
   }
   else {
      // Let's fallback to a set of coordinates here in NYC
      context.setUserLocation(new Location(40.732561, -73.988068));
   }

   // Prepare the Button for display with our context
   buttonDropin.prepareForDisplayWithContext(context); // OR:
   buttonDropin.prepareForDisplayWithContext(context, new ButtonDropin.Listener() {
      @Override
      void onPrepared(final boolean willDisplay) {
          // Toggle visibility of UI items here if necessary
      }

      @Override
      void onClick(final ButtonDropin dropin) {
          // You can put for example your own analytics tracking here
      }
   });
 

Add a Button to your view with code.

     final ButtonDropin buttonDropin = new ButtonDropin(context);
     // Important, you have to set the Button ID before calling any of the prepareForDisplay methods.
     buttonDropin.setButtonId("your-button-id");
     // Let's do some styling
     Resources res = context.getResources();
     buttonDropin.setTextSize_Button(res.getDimensionPixelSize(R.dimen.my_text_size));
     buttonDropin.setTextColor_Button(Color.RED);


     // Remember to set some layout params if you add the button to a ViewGroup that requires this.
     final LayoutParams layoutParams = new LayoutParams(MATCH_PARENT, res.getDimensionPixelSize(R.dimen.button_height));
     buttonDropin.setLayoutParams(layoutParams);
     someParentView.addView(buttonDropin);

     // Prepare the Button for display with some context.
     final ButtonContext context = ButtonContext.withSubjectLocation(new Location("Button HQ", 40.732561,-73.988068)));
     final userLocation = new LocationProvider(this).getBestLocation();
     if (userLocation != null) {
       context.setUserLocation(new Location(userLocation));
     }

     buttonDropin.prepareForDisplayWithContext(context);
 

Summary

[Expand] Inherited Methods
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait(long arg0, int arg1) final void wait(long arg0) final void wait()