1 /******************************************************************************* 2 * Copyright (c) 2006 IBM Corporation and others. 3 * All rights reserved. This program and the accompanying materials 4 * are made available under the terms of the Eclipse Public License v1.0 5 * which accompanies this distribution, and is available at 6 * http://www.eclipse.org/legal/epl-v10.html 7 * 8 * Contributors: 9 * IBM Corporation - initial API and implementation 10 ******************************************************************************/ 11 12 package org.eclipse.ui.internal.menus; 13 14 /** 15 * <p> 16 * A utility class for breaking apart locations into their component parts. 17 * </p> 18 * <p> 19 * Only intended for use within the <code>org.eclipse.jface.menus</code> 20 * package. 21 * </p> 22 * <p> 23 * <strong>PROVISIONAL</strong>. This class or interface has been added as 24 * part of a work in progress. There is a guarantee neither that this API will 25 * work nor that it will remain the same. Please do not use this API without 26 * consulting with the Platform/UI team. 27 * </p> 28 * <p> 29 * This class will eventually exist in <code>org.eclipse.jface.menus</code>. 30 * </p> 31 * 32 * @since 3.2 33 */ 34 interface ILocationElementTokenizer { 35 36 /** 37 * Returns whether there are more elements in this tokenizer. 38 * 39 * @return <code><code>true</code> if there are more tokens; <code>false</code> otherwise. 40 */ 41 boolean hasMoreTokens(); 42 43 /** 44 * Returns the next token, and increments the internal state. 45 * 46 * @return The next token; may be <code>null</code> if there are no more 47 * tokens. 48 */ 49 LocationElementToken nextToken(); 50 } 51