/*
 *                 Sun Public License Notice
 * 
 * The contents of this file are subject to the Sun Public License
 * Version 1.0 (the "License"). You may not use this file except in
 * compliance with the License. A copy of the License is available at
 * http://www.sun.com/
 * 
 * The Original Code is NetBeans. The Initial Developer of the Original
 * Code is Sun Microsystems, Inc. Portions Copyright 1997-2002 Sun
 * Microsystems, Inc. All Rights Reserved.
 */

package org.netbeans.modules.xsl.api;

import org.w3c.dom.Node;
import java.awt.Component;
import org.openide.loaders.DataObject;

/**
 * The XPathCustomizer is an interface to enable editing an XPath in a source document.
 * By implementing the interface any editor can launch the XPathCustomizer when an XPath needs
 * to be customized.
  */
public interface XSLCustomizer {	    
    /**
     * Returns the Component used to edit the XPath.
     * @param node the Node instance to be customized.
     * @param dataObject the DataObject representing the XSL document.
	 *            ScenarioCookie can be fetched from this DataObject using
	 *            dataObject.getCookie(ScenarioCookie.class).
     * @return the Component used to edit the XPath.
     */
    public Component getCustomizer(Node node, DataObject dataObject);

    /**
     * Indicates if this customizer can return a customizing component for this
     * node.
     * @param node the Node instance to be customized.
     * @return true if a customizer is supported for this node, otherwise false.
     */
    public boolean hasCustomizer(Node node);
}