protected boolean onBeginListeningQuery(BeginListeningQuery query) {
NullCheck.notNull(query, "query");
final int index = selectedIndex();
if (index < 0) return false;
final int count = model.getItemCount();
if (index >= count) return false;
final Object current = model.getItem(index);
final String text =
appearance
.getScreenAppearance(current, NONE_APPEARANCE_FLAGS)
.substring(hotPointX, appearance.getObservableRightBound(current));
// Log.debug("listen", appearance.getScreenAppearance(current, NONE_APPEARANCE_FLAGS));
// Log.debug("listen", "" + hotPointX);
if (text.isEmpty() && index + 1 >= count) return false;
if (index + 1 < count) {
final Object next = model.getItem(index + 1);
query.answer(
new BeginListeningQuery.Answer(
text, new ListeningInfo(index + 1, appearance.getObservableLeftBound(next))));
} else
query.answer(
new BeginListeningQuery.Answer(
text, new ListeningInfo(index, appearance.getObservableRightBound(current))));
return true;
}
protected boolean onChar(KeyboardEvent event) {
if (noContent()) return true;
final int count = model.getItemCount();
final char c = event.getChar();
final String beginning;
if (selected() != null) {
if (hotPointX >= appearance.getObservableRightBound(selected())) return false;
final String name = getObservableSubstr(selected());
final int pos =
Math.min(hotPointX - appearance.getObservableLeftBound(selected()), name.length());
if (pos < 0) return false;
beginning = name.substring(0, pos);
} else beginning = "";
Log.debug("list", "beginning:" + beginning);
final String mustBegin = beginning + c;
for (int i = 0; i < count; ++i) {
Log.debug("list", "checking:" + i);
final String name = getObservableSubstr(model.getItem(i));
Log.debug("list", "name:" + name);
if (!name.startsWith(mustBegin)) continue;
hotPointY = getLineIndexByItemIndex(i);
Log.debug("list", "hotPointY:" + hotPointY);
++hotPointX;
appearance.announceItem(model.getItem(hotPointY), NONE_APPEARANCE_FLAGS);
environment.onAreaNewHotPoint(this);
return true;
}
return false;
}
private boolean onAltLeft(KeyboardEvent event) {
if (noContent()) return true;
final Object item = selected();
if (item == null) {
environment.hint(Hints.EMPTY_LINE);
return true;
}
final String line = appearance.getScreenAppearance(item, NONE_APPEARANCE_FLAGS);
NullCheck.notNull(line, "line");
if (line.isEmpty()) {
environment.hint(Hints.EMPTY_LINE);
return true;
}
final int leftBound = appearance.getObservableLeftBound(item);
final int rightBound = appearance.getObservableRightBound(item);
if (hotPointX <= leftBound) {
environment.hint(Hints.BEGIN_OF_LINE);
return true;
}
final String subline = line.substring(leftBound, rightBound);
final WordIterator it = new WordIterator(subline, hotPointX - leftBound);
if (!it.stepBackward()) {
environment.hint(Hints.BEGIN_OF_LINE);
return true;
}
hotPointX = it.pos() + leftBound;
environment.say(it.announce());
environment.onAreaNewHotPoint(this);
return true;
}
protected boolean onMoveHotPoint(MoveHotPointEvent event) {
NullCheck.notNull(event, "event");
final int x = event.getNewHotPointX();
final int y = event.getNewHotPointY();
final int newY;
if (y >= getLineCount()) {
if (event.precisely()) return false;
newY = getLineCount() - 1;
} else newY = y;
if (getItemIndexOnLine(newY) >= 0) {
// Line with item, not empty
final Object item = model.getItem(getItemIndexOnLine(newY));
final int leftBound = appearance.getObservableLeftBound(item);
final int rightBound = appearance.getObservableRightBound(item);
if (event.precisely() && (x < leftBound || x > rightBound)) return false;
hotPointY = newY;
hotPointX = x;
if (hotPointX < leftBound) hotPointX = leftBound;
if (hotPointX > rightBound) hotPointX = rightBound;
environment.onAreaNewHotPoint(this);
return true;
}
// On empty line
hotPointY = newY;
hotPointX = 0;
environment.onAreaNewHotPoint(this);
return true;
}
protected String getObservableSubstr(Object item) {
NullCheck.notNull(item, "item");
final String line = appearance.getScreenAppearance(item, NONE_APPEARANCE_FLAGS);
NullCheck.notNull(line, "line");
if (line.isEmpty()) return "";
final int leftBound = Math.min(appearance.getObservableLeftBound(item), line.length());
final int rightBound = Math.min(appearance.getObservableRightBound(item), line.length());
if (leftBound >= rightBound) return "";
return line.substring(leftBound, rightBound);
}
private boolean onAltHome(KeyboardEvent event) {
if (noContent()) return true;
final Object item = selected();
NullCheck.notNull(item, "item");
final String line = appearance.getScreenAppearance(item, NONE_APPEARANCE_FLAGS);
NullCheck.notNull(line, "line");
hotPointX = appearance.getObservableLeftBound(item);
announceChar(line, hotPointX, appearance.getObservableRightBound(item));
environment.onAreaNewHotPoint(this);
return true;
}
/**
* Searches for the item in the model and sets hot point on it. Given an arbitrary object, this
* method looks through all items in the model and does a couple of checks: literal pointers
* equality and a check with {@code equals()} method. If at least one of these checks succeeds,
* the item is considered equal to the given one, and hot points is set on it.
*
* @param obj The object to search for
* @param introduce Must be true if it is necessary to introduce the object, once it's found
* @return True if the request object is found, false otherwise
*/
public boolean select(Object obj, boolean introduce) {
NullCheck.notNull(obj, "obj");
for (int i = 0; i < model.getItemCount(); ++i) {
final Object o = model.getItem(i);
if (o == null || (obj != o && !obj.equals(o))) continue;
hotPointY = i;
hotPointX = appearance.getObservableLeftBound(o);
environment.onAreaNewHotPoint(this);
if (introduce) appearance.announceItem(o, NONE_APPEARANCE_FLAGS);
return true;
}
return false;
}
private boolean onAltEnd(KeyboardEvent event) {
if (noContent()) return true;
final Object item = selected();
if (item == null) {
environment.hint(Hints.EMPTY_LINE);
return true;
}
final String line = appearance.getScreenAppearance(item, NONE_APPEARANCE_FLAGS);
NullCheck.notNull(line, "line");
hotPointX = appearance.getObservableRightBound(item);
environment.hint(Hints.END_OF_LINE);
environment.onAreaNewHotPoint(this);
return true;
}
protected boolean onListeningFinishedEvent(ListeningFinishedEvent event) {
NullCheck.notNull(event, "event");
if (!(event.getExtraInfo() instanceof ListeningInfo)) return false;
final ListeningInfo info = (ListeningInfo) event.getExtraInfo();
final int count = model.getItemCount();
if (info.itemIndex >= count) return false;
final Object item = model.getItem(info.itemIndex);
final int leftBound = appearance.getObservableLeftBound(item);
final int rightBound = appearance.getObservableRightBound(item);
if (info.pos < leftBound || info.pos > rightBound) return false;
hotPointY = getLineIndexByItemIndex(info.itemIndex);
hotPointX = info.pos;
environment.onAreaNewHotPoint(this);
return true;
}
/**
* Selects the item by its index. Given the non-negative integer value as an index, this method
* sets the hot point on the item addressed with this index, checking only that index is in
* appropriate bounds. Index must address the object as a number in the model, ignoring any empty
* lines.
*
* @param index The item index to select
* @param announce Must be true, if it is necessary to announce the item , once it has been
* selected
* @return True if the index is valid and the item gets hot point on it
*/
public boolean select(int index, boolean announce) {
if (index < 0 || index >= model.getItemCount()) return false;
final int emptyCountAbove = flags.contains(Flags.EMPTY_LINE_TOP) ? 1 : 0;
hotPointY = index + emptyCountAbove;
final Object item = model.getItem(index);
if (item != null) {
hotPointX = appearance.getObservableLeftBound(item);
if (announce) appearance.announceItem(item, NONE_APPEARANCE_FLAGS);
} else {
hotPointX = 0;
if (announce) environment.hint(Hints.EMPTY_LINE);
}
environment.onAreaNewHotPoint(this);
return true;
}
@Override
public String getLine(int index) {
if (isEmpty()) return index == 0 ? noContentStr() : "";
final int itemIndex = getItemIndexOnLine(index);
if (itemIndex < 0 || itemIndex >= model.getItemCount()) return "";
final Object res = model.getItem(itemIndex);
return res != null ? appearance.getScreenAppearance(res, NONE_APPEARANCE_FLAGS) : "";
}
public void resetHotPoint(boolean introduce) {
hotPointY = 0;
final int count = model.getItemCount();
if (count < 1) {
hotPointX = 0;
environment.onAreaNewHotPoint(this);
return;
}
final Object item = model.getItem(0);
if (item != null) {
hotPointX = item != null ? appearance.getObservableLeftBound(item) : 0;
if (introduce) appearance.announceItem(item, NONE_APPEARANCE_FLAGS);
} else {
hotPointX = 0;
environment.hint(Hints.EMPTY_LINE);
}
environment.onAreaNewHotPoint(this);
}
protected boolean onAnnounce() {
environment.playSound(Sounds.INTRO_REGULAR);
String item = "";
if (selected() != null)
item =
appearance.getScreenAppearance(selected(), EnumSet.noneOf(Appearance.Flags.class)).trim();
if (!item.isEmpty()) item = " " + item;
environment.say(getAreaName() + item);
return true;
}
protected boolean onAnnounceLine() {
if (isEmpty()) return false;
final Object item = selected();
if (item == null) {
environment.hint(Hints.EMPTY_LINE);
return true;
}
appearance.announceItem(item, NONE_APPEARANCE_FLAGS);
return true;
}
protected void onNewHotPointY(boolean briefAnnouncement) {
final int index = selectedIndex();
if (index < 0) {
environment.hint(Hints.EMPTY_LINE);
hotPointX = 0;
environment.onAreaNewHotPoint(this);
return;
}
final Object item = model.getItem(index);
if (item == null) {
environment.hint(Hints.EMPTY_LINE);
hotPointX = 0;
environment.onAreaNewHotPoint(this);
return;
}
appearance.announceItem(
item, briefAnnouncement ? BRIEF_ANNOUNCEMENT_ONLY : NONE_APPEARANCE_FLAGS);
hotPointX = appearance.getObservableLeftBound(item);
environment.onAreaNewHotPoint(this);
}
protected boolean onArrowRight(KeyboardEvent event) {
if (noContent()) return true;
final Object item = selected();
NullCheck.notNull(item, "item");
final String line = appearance.getScreenAppearance(item, NONE_APPEARANCE_FLAGS);
NullCheck.notNull(line, "line");
if (line.isEmpty()) {
environment.hint(Hints.EMPTY_LINE);
return true;
}
final int rightBound = appearance.getObservableRightBound(item);
if (hotPointX >= rightBound) {
environment.hint(Hints.END_OF_LINE);
return true;
}
++hotPointX;
announceChar(line, hotPointX, rightBound);
environment.onAreaNewHotPoint(this);
return true;
}
@Override
public RegionContent getRegion(int fromX, int fromY, int toX, int toY) {
if (model == null || model.getItemCount() < 0) return null;
if (fromY >= model.getItemCount() || toY > model.getItemCount()) return null;
if (fromY == toY) {
final String line =
appearance.getScreenAppearance(model.getItem(fromY), NONE_APPEARANCE_FLAGS);
if (line == null || line.isEmpty()) return null;
final int fromPos = fromX < line.length() ? fromX : line.length();
final int toPos = toX < line.length() ? toX : line.length();
if (fromPos >= toPos) return null;
return new RegionContent(new String[] {line.substring(fromPos, toPos)});
}
final LinkedList<String> res = new LinkedList<String>();
for (int i = fromY; i < toY; ++i) {
final String line = appearance.getScreenAppearance(model.getItem(i), NONE_APPEARANCE_FLAGS);
res.add(line != null ? line : "");
}
res.add("");
return new RegionContent(res.toArray(new String[res.size()]));
}
@Override
public RegionContent getWholeRegion() {
if (model == null || model.getItemCount() < 0) return null;
final LinkedList<String> res = new LinkedList<String>();
final int count = model.getItemCount();
for (int i = 0; i < count; ++i) {
final String line = appearance.getScreenAppearance(model.getItem(i), NONE_APPEARANCE_FLAGS);
res.add(line != null ? line : "");
}
res.add("");
return new RegionContent(res.toArray(new String[res.size()]));
}
/**
* Refreshes the content of the list. This method calls {@code refresh()} method of the model and
* displays new items. It does not produce any speech announcement of the change. HotPointY is
* preserved if it is possible (meaning, the new number of lines not less than old value of
* hotPointY), but hotPointX is moved to the beginning of the line.
*/
public void refresh() {
model.refresh();
final int count = model.getItemCount();
if (count == 0) {
hotPointX = 0;
hotPointY = 0;
environment.onAreaNewContent(this);
environment.onAreaNewHotPoint(this);
return;
}
hotPointY = hotPointY < count ? hotPointY : count - 1;
final Object item = model.getItem(hotPointY);
if (item != null) hotPointX = appearance.getObservableLeftBound(item);
else hotPointX = 0;
environment.onAreaNewContent(this);
environment.onAreaNewHotPoint(this);
}
public void announceSelected() {
final Object item = selected();
if (item != null) appearance.announceItem(item, NONE_APPEARANCE_FLAGS);
}