PresentationFragment.java

/***
  Copyright (c) 2013 CommonsWare, LLC
  
  Licensed under the Apache License, Version 2.0 (the "License"); you may
  not use this file except in compliance with the License. You may obtain
  a copy of the License at
    http://www.apache.org/licenses/LICENSE-2.0
  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
 */

package com.commonsware.cwac.preso;

import android.app.Dialog;
import android.app.DialogFragment;
import android.app.Presentation;
import android.content.Context;
import android.os.Bundle;
import android.view.Display;

/**
 * Fragment that can display its content in a Presentation. Otherwise,
 * it largely behaves like an ordinary DialogFragment.
 */
abstract public class PresentationFragment extends DialogFragment {
  private Display display=null;
  private Presentation preso=null;

  /**
   * {@inheritDoc}
   */
  @Override
  public Dialog onCreateDialog(Bundle savedInstanceState) {
    if (preso == null) {
      return(super.onCreateDialog(savedInstanceState));
    }

    return(preso);
  }

  /**
   * Call this to provide the Display for the Presentation and to actually
   * set up the Presentation. Otherwise, this fragment will behave like
   * an ordinary DialogFragment.
   *
   * @param ctxt a Context associated with this Display
   * @param display the Display on which to show the Presentation
   */
  public void setDisplay(Context ctxt, Display display) {
    if (display == null) {
      preso=null;
    }
    else {
      preso=new Presentation(ctxt, display, getTheme());
    }

    this.display=display;
  }

  /**
   * @return the Display supplied via setDisplay
   */
  public Display getDisplay() {
    return(display);
  }

  /**
   * @return the Context associated with the Presentation (via setDisplay())
   * where available
   */
  public Context getContext() {
    if (preso != null) {
      return(preso.getContext());
    }

    return(getActivity());
  }
}