Android Open Source - holoaccent Accent Helper

• Back to UI/color  ↑

From Project

Back to project page holoaccent.

License

The source code is released under:

Apache License

Java Source Code

/*******************************************************************************
 * Copyright 2013 NEGU Soft//w  w  w .j av  a  2  s.  c o m
 * 
 * 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.
 ******************************************************************************/
/*
 * Copyright (C) 2012 The Android Open Source Project
 *
 * 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.negusoft.holoaccent;

import android.content.Context;
import android.content.res.Resources;
import android.view.Window;

import com.negusoft.holoaccent.dialog.DividerPainter;

/**
 * Helper class to lazily initialize AccentResources from your activities. 
 * Simply add the following code to your activity in order to replace the 
 * default android Resources implementation by AccentResources:
 * <pre><code>
private final AccentHelper mAccentHelper = new AccentHelper();
{@literal @}Override
public Resources getResources() {
  return mAccentHelper.getResources(this, super.getResources());
}
 * </code></pre>
 * And don't forget to add the corresponding imports:
 * <pre><code>
import com.negusoft.holoaccent.AccentHelper;
import android.content.res.Resources;
 * </code></pre>
 * 
 * In addition, it allows to easily prepare dialogs for display by calling: 
 * prepareDialog().
 */
public class AccentHelper {

    public interface OnInitListener {
        public void onInitResources(AccentResources resources);
    }

    public static final int COLOR_NO_OVERRIDE = 0;

    /**
     * Get the AccentPalette instance from the the context.
     * @return It might return null if HoloAccent has not been correctly configured.
     */
    public static AccentPalette getPalette(Context context) {
        Resources resources = context.getResources();
        if (!(resources instanceof AccentResources))
            return null;
        return ((AccentResources)resources).getPalette();
    }
  
  private AccentResources mAccentResources;
  private DividerPainter mDividerPainter;
  
  private final boolean mOverrideThemeColor;
    private final int mOverrideColor;
    private final int mOverrideColorDark;
    private final int mOverrideColorActionBar;

    private OnInitListener mInitListener;
  
  public AccentHelper() {
    mOverrideThemeColor = false;
    mOverrideColor = 0;
        mOverrideColorDark = 0;
        mOverrideColorActionBar = 0;
  }

    /**
     * Initialize by specifying a explicit color.
     * @param color The color to override. If it is 0, it will not override the color so it
     *              will be taken from the theme.
     * @param colorDark The dark version to override. If it is 0, it be taken from the theme.
     *                  Or it will be calculated from the main color if it not specified in
     *                  the theme either.
     * @param colorActionBar The action bar version to override. If it is 0, it will be taken
     *                       from the theme. Or same as the main color if it not specified in
     *                       the theme either.
     */
    public AccentHelper(int color, int colorDark, int colorActionBar) {
        this(color, colorDark, colorActionBar, null);
    }

    /**
     * Initialize by specifying a explicit color.
     * @param color The color to override. If it is 0, it will not override the color so it
     *              will be taken from the theme.
     * @param colorDark The dark version to override. If it is 0, it be taken from the theme.
     *                  Or it will be calculated from the main color if it not specified in
     *                  the theme either.
     * @param colorActionBar The action bar version to override. If it is 0, it will be taken
     *                       from the theme. Or same as the main color if it not specified in
     *                       the theme either.
     * @param listener Listener to receive the init event.
     */
    public AccentHelper(int color, int colorDark, int colorActionBar, OnInitListener listener) {
        mOverrideThemeColor =  color != COLOR_NO_OVERRIDE;
        mOverrideColor = color;
        mOverrideColorDark = colorDark;
        mOverrideColorActionBar = colorActionBar;
        mInitListener = listener;
    }
  
  /** @return The AccentResources instance, properly initialized. */
  public Resources getResources(Context c, Resources resources) {
    if (mAccentResources == null) {
            mAccentResources = createInstance(c, resources);
            if (mInitListener != null)
                mInitListener.onInitResources(mAccentResources);
        }
    return mAccentResources;
  }
  
  /** Paint the dialog's divider if required to correctly customize it. */
  public void prepareDialog(Context c, Window window) {
    if (mDividerPainter == null)
      mDividerPainter = initPainter(c, mOverrideColor);
    mDividerPainter.paint(window);
  }

    /**
     * Set a listener to be notified when the instance of AccentResources is created.
     * @param listener The actual listener or null to disable any event reporting.
     */
    public void setOnInitListener(OnInitListener listener) {
        mInitListener = listener;
    }

    private DividerPainter initPainter(Context c, int color) {
        return color == 0 ? new DividerPainter(c) : new DividerPainter(color);
    }
  
  private AccentResources createInstance(Context c, Resources resources) {
        return new AccentResources(c, resources, mOverrideColor, mOverrideColorDark, mOverrideColorActionBar);
  }

}

Java Source Code List

• Back to UI/color  ↑