06/2012 - KaffeeKlatsch

Falls gerade kein Selektionsmodus aktiv ist, kann dieser
über die startActionMode-Methode, die von der Activity
bereitgestellt wird, gestartet werden. Die Methode erwartet
ein Callback-Objekt, dass verschiedene Hooks
in den Lebenszyklus der Contextual Action Mode zur
Verfügung stellt. Beim Erzeugen des Modus muss die
Contextual Action Bar erzeugt und mit Action Items
gefüllt werden. Dies erfolgt wie gewohnt mit Hilfe von
in XML erzeugten Menüdateien. Die onPrepareAction-
Mode-Methode ermöglicht das Aktivieren/Deaktivieren
von bestimmten Menüelementen. Dies ist dann nötig,
wenn sich die Anzahl der ausgewählten Bildnotizen
ändert und einige Aktionen nicht mehr auf die aktuelle
Selektion anwendbar sind. Wenn der Benutzer auf
ein Action Item klickt, kann in der onActionItemClicked-
Methode die erforderliche Aktion angestoßen werden.
Bei der Beendigung des Selektionsmodus bietet die
onDestroyActionMode-Methode den richtigen Ort für die
entsprechenden Aufräumarbeiten. In diesem Fall wird
das ActionMode-Objekt dereferenziert und der Selektionszustand
aller Listenelemente zurückgesetzt.
private void tryInvokeCab() {
if (mActionMode == null) {
mActionMode = startActionMode(mActionModeCallback);
mActionMode.setTitle(
"1 " + getResources().getString(R.string.note_selection)
);
}
}
private ActionMode.Callback mActionModeCallback =
new ActionMode.Callback() {
@Override
public boolean onCreateActionMode(
ActionMode mode, Menu menu
) {
mode.getMenuInflater().inflate(
R.menu.image_notes_cab, menu
);
return true;
}
@Override
public boolean onPrepareActionMode(
ActionMode mode, Menu menu
) {
if (mImageNotesAdapter.getSelectedCount() == 1) {
menu.findItem(R.id.menu_share).setVisible(true);
menu.findItem(R.id.menu_share).setEnabled(true);
} else {
menu.findItem(R.id.menu_share).setVisible(false);
menu.findItem(R.id.menu_share).setEnabled(false);
}
return true;
}
(Einheits-)Gewänder für den Androiden
@Override
public boolean onActionItemClicked(
ActionMode mode, MenuItem item
) {
switch (item.getItemId()) {
// Executes the selected action...
}
@Override
public void onDestroyActionMode(ActionMode mode) {
closeCab();
}
};
private void closeCab() {
mImageNotesAdapter.resetSelection();
mActionMode = null;
}
Am Ende bleibt noch die Definition eines OnSelection-
ChangedListener, der über jede Auswahländerung informiert
wird. Seine Aufgabe ist es an Hand der übergebenen
Anzahl der ausgewählten Elemente den Titel der
Contextual Action Bar auf den neuesten Stand zu bringen
und gegebenenfalls eine Aktualisierung der Action Items
vorzunehmen, indem er die invalidate-Methode auf dem
ActionMode-Objekt aufruft. Dies führt dann zur Ausführung
der weiter oben bereits beschriebenen onPrepare-
ActionMode-Methode. Falls keine Listenelemente mehr
ausgewählt sind, beendet er den Selektionsmodus.
private final OnSelectionChangedListener
mOnSelectionChangedListener =
new OnSelectionChangedListener() {
@Override
public void onSelectionChanged(
CheckedImageNoteView view,
boolean selected, int selectedCount) {
if (selectedCount < 1) {
mActionMode.finish();
} else if (selectedCount == 1) {
mActionMode.setTitle(
selectedCount + " "+ getResources().getString(
R.string.note_selection
)
);
mActionMode.invalidate();
} else {
mActionMode.setTitle(
selectedCount + " "+ getResources().getString(
R.string.notes_selection)
);
if (selected) {
mActionMode.invalidate();
}
}
}
};
Seite 15 KaffeeKlatsch Jahrgang 5 / Nr. 6 / Juni 2012