/*******************************************************************************
 * Copyright (c) 2000, 2007 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/

package org.eclipse.help.internal.base;

/**
 * @since 3.0
 */
public interface IHelpActivitySupport {

	/**
	 * Checks if href matches an enabled activity. If it does not match any
	 * defined activites, it is assumed to be enabled. If Help role filtering is
	 * disabled, this method always returns <code>true</code>.
	 * 
	 * @param href
	 * @return
	 */
	public boolean isEnabled(String href);

	/**
	 * Checks if href is matches an enabled activity. If it does not match any
	 * defined activites, it is assumed to be enabled.
	 * 
	 * @param href
	 *            the topic href
	 * @return <code>true</code> if role for this href is enabled,
	 *         <code>false</code> otherwise.
	 */
	public boolean isRoleEnabled(String href);

	/**
	 * Checks whether topic belongs to a TOC that mathes enabled activity.
	 * Enabled children TOCs are searched if linked by also enabled TOCs.
	 * Additionally topic may match description topic of a root TOC.
	 * 
	 * @return true if topic belongs to an enabled TOC
	 * @param href
	 * @param locale
	 *            locale for which TOCs are checked
	 */
	public boolean isEnabledTopic(String href, String locale);

	/**
	 * Enables activities with patterns matching the href
	 * 
	 * @param href
	 */
	public void enableActivities(String href);

	public boolean isFilteringEnabled();

	public void setFilteringEnabled(boolean enabled);

	public boolean isUserCanToggleFiltering();

	/**
	 * Returns the message to show in the warning dialog when filtering is
	 * toggled off.
	 * 
	 * @return the message for the filtering warning dialog
	 */
	public String getShowAllMessage();

	/**
	 * Returns document message for disabled activities.
	 * 
	 * @param embedded
	 *            if <code>true</code>, the message will be added to a
	 *            document in the workbench window. Otherwise, it will be shown
	 *            in a separate Help window.
	 * @return the document message with Java script string substituted if
	 *         found.
	 */
	public String getDocumentMessage(boolean embedded);

	/**
	 * Returns the label for the checkbox in the local scope page
	 * that allows search hits from disabled activities to be shown. 
	 * @return the checkbox label 
	 */
	public String getLocalScopeCheckboxLabel();

	/**
	 * @param embedded
	 *            if <code>true</code>, the message will be added to a
	 *            document in the workbench window. Otherwise, it will be shown
	 *            in a separate Help window.
	 * @return <code>true</code> if the document message uses live help and
	 *         requires live help Java script header, or <code>false</code>
	 *         otherwise.
	 */
	public boolean getDocumentMessageUsesLiveHelp(boolean embedded);
}
