IRowFocusListener.java
上传用户:hengxinggs
上传日期:2008-01-15
资源大小:212k
文件大小:2k
- /*
- * Copyright (C) 2005 David Orme <djo@coconut-palm-software.com>
- *
- * 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:
- * David Orme - Initial API and implementation
- */
- package org.eclipse.jface.examples.databinding.compositetable;
- import org.eclipse.swt.widgets.Control;
- /**
- * Interface IRowFocusListener. An interface for objects that want to listen to and have the
- * possibility of vetoing row change events on a CompositeTable.
- *
- * @author djo
- */
- public interface IRowFocusListener {
- /**
- * Method requestRowChange. Requests permission to change rows. This method is
- * called immediately before a row change occurs. Listeners must return true to
- * grant permission for the row change to occur or return false to veto it. If
- * any listener returns false, the entire row change operation is aborted.<p>
- *
- * @param sender The CompositeTable sending the event.
- * @param currentObjectOffset The offset of the current object in the data structure.
- * @param row The row control that is losing focus.
- * @return true to permit the row change to occur; false otherwise.
- */
- boolean requestRowChange(CompositeTable sender, int currentObjectOffset, Control row);
-
- /**
- * Method depart. Called after requstRowChange has been called to indicate that
- * the focus is departing the specified row.
- *
- * @param sender
- * @param currentObjectOffset
- * @param row
- */
- void depart(CompositeTable sender, int currentObjectOffset, Control row);
- /**
- * Method arrive. Notifies receiver that the current row has just been changed.
- *
- * @param sender The CompositeTable sending the event.
- * @param currentObjectOffset The 0-based offset to the row that should be populated
- * @param newRow The actual SWT row object that needs to be populated with data
- */
- void arrive(CompositeTable sender, int currentObjectOffset, Control newRow);
- }