com.jidesoft.hints.IntelliHints Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jide-oss Show documentation

JIDE Common Layer (Professional Swing Components)

There is a newer version: 3.6.18

/*
 * @(#)IntelliHints.java 7/24/2005
 *
 * Copyright 2002 - 2005 JIDE Software Inc. All rights reserved.
 */
package com.jidesoft.hints;

import javax.swing.*;

/**
 * IntelliHints is an interface that defines all necessary methods to implement showing
 * a hint popup depending on a context and allows user to pick from a list of hints. {@link
 * #createHintsComponent()} will create a component that contains the hints. It will be shown in a
 * popup window. After hint popup is created, {@link #updateHints(Object)} will update the content
 * of hints based on the context. Once user picks a hint from the hint popup, {@link
 * #getSelectedHint()} will be called to find the hint that user selected and call {@link
 * #acceptHint(Object)} to accept it.
 */
public interface IntelliHints {
    /**
     * The key of a client property. If a component has intellihints registered, you can use this
     * client property to get the IntelliHints instance.
     */
    String CLIENT_PROPERTY_INTELLI_HINTS = "INTELLI_HINTS"; //NOI18N

    /**
     * Creates the component which contains hints. At this moment, the content should be empty.
     * Following call {@link #updateHints(Object)} will update the content.
     *
     * @return the component which will be used to display the hints.
     */
    JComponent createHintsComponent();

    /**
     * Update hints depending on the context.
     *
     * @param context the current context
     *
     * @return true or false. If it is false, hint popup will not be shown.
     */
    boolean updateHints(Object context);

    /**
     * Gets the selected value. This value will be used to complete the text component.
     *
     * @return the selected value.
     */
    Object getSelectedHint();

    /**
     * Accepts the selected hint.
     *
     * @param hint
     */
    void acceptHint(Object hint);
}