org.xmind.core.ITopic Maven / Gradle / Ivy
Show all versions of xmindjbehaveplugin Show documentation
/* ******************************************************************************
* Copyright (c) 2006-2012 XMind Ltd. and others.
*
* This file is a part of XMind 3. XMind releases 3 and
* above are dual-licensed under the Eclipse Public License (EPL),
* which is available at http://www.eclipse.org/legal/epl-v10.html
* and the GNU Lesser General Public License (LGPL),
* which is available at http://www.gnu.org/licenses/lgpl.html
* See http://www.xmind.net/license.html for details.
*
* Contributors:
* XMind Ltd. - initial API and implementation
*******************************************************************************/
package org.xmind.core;
import java.util.List;
import java.util.Set;
import org.xmind.core.marker.IMarkerRef;
import org.xmind.core.style.IStyled;
/**
* @author briansun
*
*/
public interface ITopic extends ITitled, IStyled, IRelationshipEnd, IAdaptable,
ILabeled, ITopicComponent, IPositioned, IModifiable {
/**
* Type for the root topic (value='root').
*
* @see org.xmind.core.ITopic#getType()
*/
public static final String ROOT = "root"; //$NON-NLS-1$
/**
* Type for topics directly attached to their parent topics
* (value='attached').
*
* @see org.xmind.core.ITopic#getType()
*/
public static final String ATTACHED = "attached"; //$NON-NLS-1$
/**
* Type for topics detached from their parent topics (value='detached').
*
* @see org.xmind.core.ITopic#getType()
*/
public static final String DETACHED = "detached"; //$NON-NLS-1$
/**
* Type for topics attached on their parent topics' summaries
* (value='summary').
*
* @see org.xmind.core.ITopic#getType()
*/
public static final String SUMMARY = "summary"; //$NON-NLS-1$
public static final int UNSPECIFIED = -1;
/**
* @return
*/
boolean isFolded();
/**
* @param folded
*/
void setFolded(boolean folded);
/**
* Gets the type of this topic.
*
* A topic's Type is a {@link String} used to define how this topic
* is connected to its parent topic, such as 'attached'
* (directly connected), 'detached' (totally separated), or '
* summary' (attached on a summary), etc. This attribute
* matters when it is required how a topic and its parent topic are painted
* on graphics.
*
*
* A root topic always returns a special type 'root' since it has NO parent
* topic.
*
*
* If this topic has not been added to any parent topic, or its type is not
* specified, null is returned.
*
*
* @return The type of this topic, or null indicating that the
* type is unspecified
*
* @see org.xmind.core.ITopic#ATTACHED
* @see org.xmind.core.ITopic#DETACHED
* @see org.xmind.core.ITopic#SUMMARY
* @see org.xmind.core.ITopic#ROOT
*/
String getType();
/**
* @return Whether this topic is directly connected to its parent topic
*
* @see #getType();
*/
boolean isAttached();
/**
* Gets all children topics of this topic.
*
* NOTE: This list is not supposed to be modifiable. Use
* {@link #add(org.xmind.core.ITopic)}, {@link #add(org.xmind.core.ITopic, String)},
* {@link #add(org.xmind.core.ITopic, int, String)} or {@link #remove(org.xmind.core.ITopic)} to
* add/remove child topic to this topic.
*
*
* @return A list containing all children topics of this topic
*/
List getAllChildren();
/**
* Gets this topic's children topics that are of the specified type.
*
* If this topic has NO children topics that are of this type, or the type
* is null, an empty list will be returned.
*
*
* NOTE: This list is not supposed to be modifiable. Use
* {@link #add(org.xmind.core.ITopic)}, {@link #add(org.xmind.core.ITopic, String)},
* {@link #add(org.xmind.core.ITopic, int, String)} or {@link #remove(org.xmind.core.ITopic)} to
* add/remove child topic to this topic.
*
*
* @param type
* The children's type.
* @return A list containing this topic's children topics that are of the
* specified type
*
* @see #getType()
*/
List getChildren(String type);
/**
*
* @param type
* @return
*/
boolean hasChildren(String type);
/**
*
* @return
*/
Set getChildrenTypes();
/**
* @param child
*/
void add(ITopic child);
/**
* @param child
* @param type
* The child's type.
*/
void add(ITopic child, String type);
/**
* @param child
* @param index
* @param type
* The child's type.
*/
void add(ITopic child, int index, String type);
/**
* @param child
*/
void remove(ITopic child);
/**
* @return
*/
ITopicPath getPath();
/**
* @return
*/
int getIndex();
/**
* @param string
*/
void setHyperlink(String hyperlink);
/**
* @return
*/
String getHyperlink();
/**
* @return
*/
INotes getNotes();
/**
*
* @return
*/
INumbering getNumbering();
/**
* @return
*/
boolean isRoot();
void addMarker(String markerId);
void removeMarker(String markerId);
boolean hasMarker(String markerId);
Set getMarkerRefs();
void addBoundary(IBoundary boundary);
void removeBoundary(IBoundary boundary);
Set getBoundaries();
void addSummary(ISummary summary);
void removeSummary(ISummary summary);
Set getSummaries();
String getStructureClass();
void setStructureClass(String structureClass);
IImage getImage();
int getTitleWidth();
void setTitleWidth(int width);
ITopicExtension getExtension(String providerName);
ITopicExtension createExtension(String providerName);
void deleteExtension(String providerName);
long getModifiedTime();
}