ActionBar Classe

Definizione

Spazio dei nomi:

Android.App

Assembly:

Mono.Android.dll

Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.

[Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)]
public abstract class ActionBar : Java.Lang.Object

[<Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)>]
type ActionBar = class
    inherit Object

Ereditarietà

Object

Object

ActionBar

Attributi

RegisterAttribute

Commenti

Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.

A partire da Android 3.0 (livello API 11), la barra delle azioni viene visualizzata nella parte superiore della finestra di un'attività quando l'attività usa il tema del android.R.style#Theme_Holo Holo sistema (o uno dei relativi temi discendenti), ovvero il valore predefinito. In caso contrario, è possibile aggiungere la barra delle azioni chiamando android.view.Window#requestFeature requestFeature(FEATURE_ACTION_BAR) o dichiarandola in un tema personalizzato con la android.R.styleable#Theme_windowActionBar windowActionBar proprietà .

A partire da Android L (livello API 21), la barra delle azioni può essere rappresentata da qualsiasi widget della barra degli strumenti all'interno del layout dell'applicazione. L'applicazione può segnalare l'attività che deve essere considerata come barra delle azioni dell'attività. Le attività che usano questa funzionalità devono usare uno dei temi forniti .NoActionBar , impostare l'attributo android.R.styleable#Theme_windowActionBar windowActionBar su false o altrimenti non richiedere la funzionalità della finestra.

Modificando le funzionalità della finestra richieste dal tema e i layout usati per la visualizzazione contenuto di un'attività, un'app può usare la barra delle azioni di sistema standard nelle versioni precedenti della piattaforma e le barre degli strumenti inline più recenti nelle versioni più recenti della piattaforma. L'oggetto ActionBar ottenuto dall'attività può essere usato per controllare in modo trasparente la configurazione.

Quando si usa il tema Holo, la barra delle azioni mostra l'icona dell'applicazione a sinistra, seguita dal titolo dell'attività. Se l'attività ha un menu opzioni, è possibile selezionare elementi accessibili direttamente dalla barra delle azioni come "elementi di azione". È anche possibile modificare varie caratteristiche della barra delle azioni o rimuoverla completamente.

Quando si usano i temi material (impostazione predefinita nell'API 21 o versione successiva) il pulsante di spostamento (in precedenza "Home") occupa lo spazio precedentemente occupato dall'icona dell'applicazione. Le app che desiderano esprimere un marchio più forte devono usare i colori del marchio pesantemente nella barra delle azioni e altri chrome dell'applicazione o usare un #setLogo(int) logo al posto del testo del titolo standard.

Dall'attività è possibile recuperare un'istanza di ActionBar chiamando android.app.Activity#getActionBar getActionBar().

In alcuni casi, la barra delle azioni può essere sovrapposta da un'altra barra che consente azioni contestuali, usando un android.view.ActionModeoggetto . Ad esempio, quando l'utente seleziona uno o più elementi nell'attività, è possibile abilitare una modalità azione che offre azioni specifiche per gli elementi selezionati, con un'interfaccia utente che sostituisce temporaneamente la barra delle azioni. Anche se l'interfaccia utente può occupare lo stesso spazio, le android.view.ActionMode API sono distinte e indipendenti da quelle per ActionBar.

<div class="special reference"><h3 Developer Guide</h3>>

Per informazioni su come usare la barra delle azioni, tra cui come aggiungere elementi di azione, modalità di spostamento e altro ancora, vedere la guida per sviluppatori della barra delle azioni.

</Div>

Documentazione Java per android.app.ActionBar.

Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .

Costruttori

ActionBar()
ActionBar(IntPtr, JniHandleOwnership)	Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime.

Proprietà

Class	Restituisce la classe di runtime di questo Objectoggetto . (Ereditato da Object)
CustomView
DisplayOptions
Elevation	Ottenere l'elevazione dell'asse Z della barra delle azioni in pixel. -or- Impostare l'elevazione dell'asse Z della barra delle azioni in pixel.
Handle	Handle all'istanza di Android sottostante. (Ereditato da Object)
Height	Recuperare l'altezza corrente di ActionBar.
HideOffset	Restituisce l'offset verticale corrente della barra delle azioni. -o- Impostare l'offset di nascondi corrente della barra delle azioni.
HideOnContentScrollEnabled	Restituisce se la barra delle azioni è configurata per scorrere fuori visualizzazione insieme a un View#setNestedScrollingEnabled(boolean) nested scrolling childoggetto . -oppure- Abilitare nascondere la barra delle azioni sullo scorrimento del contenuto.
IsShowing
JniIdentityHashCode	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
JniPeerMembers	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.
NavigationItemCount	Ottenere il numero di elementi di spostamento presenti nella modalità di spostamento corrente.
NavigationMode	Restituisce la modalità di spostamento corrente.
PeerReference	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
SelectedNavigationIndex	Ottenere la posizione dell'elemento di spostamento selezionato in modalità di spostamento a schede o elenco.
SelectedTab	Restituisce la scheda attualmente selezionata se in modalità di spostamento a schede è presente almeno una scheda.
Subtitle	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.
SubtitleFormatted	Restituisce il sottotitolo ActionBar corrente in modalità standard.
TabCount	Restituisce il numero di schede attualmente registrate con la barra delle azioni.
ThemedContext	Restituisce un oggetto Context con un tema appropriato per la creazione di visualizzazioni che verranno visualizzate nella barra delle azioni.
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
Title	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.
TitleFormatted	Restituisce il titolo actionBar corrente in modalità standard.

Metodi

AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Aggiungere un listener che risponderà agli eventi di modifica della visibilità dei menu.
AddTab(ActionBar+Tab)	Obsoleti. Aggiungere una scheda da usare in modalità di spostamento a schede.
AddTab(ActionBar+Tab, Boolean)	Obsoleti. Aggiungere una scheda da usare in modalità di spostamento a schede.
AddTab(ActionBar+Tab, Int32)	Obsoleti. Aggiungere una scheda da usare in modalità di spostamento a schede.
AddTab(ActionBar+Tab, Int32, Boolean)	Obsoleti. Aggiungere una scheda da usare in modalità di spostamento a schede.
Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
Dispose()	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
Dispose(Boolean)	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
GetHashCode()	Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object)
GetTabAt(Int32)	Obsoleti. Restituisce la scheda in corrispondenza dell'indice specificato.
Hide()	Nascondere l'actionBar se è attualmente visualizzato.
JavaFinalize()	Chiamato dal Garbage Collector in un oggetto quando Garbage Collection determina che non sono presenti più riferimenti all'oggetto. (Ereditato da Object)
NewTab()	Obsoleti. Creare e restituire un nuovo ActionBar.Taboggetto .
Notify()	Riattiva un singolo thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
RemoveAllTabs()	Obsoleti. Rimuovere tutte le schede dalla barra delle azioni e deselezionare la scheda corrente.
RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Rimuovere un listener di visibilità del menu.
RemoveTab(ActionBar+Tab)	Obsoleti. Rimuovere una scheda dalla barra delle azioni.
RemoveTabAt(Int32)	Obsoleti. Rimuovere una scheda dalla barra delle azioni.
SelectTab(ActionBar+Tab)	Obsoleti. Selezionare la scheda specificata.
SetBackgroundDrawable(Drawable)	Impostare lo sfondo di ActionBar.
SetCustomView(Int32)	Impostare la barra delle azioni in modalità di spostamento personalizzata, fornendo una visualizzazione per lo spostamento personalizzato.
SetCustomView(View, ActionBar+LayoutParams)	Impostare la barra delle azioni in modalità di spostamento personalizzata, fornendo una visualizzazione per lo spostamento personalizzato.
SetDisplayHomeAsUpEnabled(Boolean)	Impostare se la casa deve essere visualizzata come "up".
SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions)	Impostare le opzioni di visualizzazione selezionate.
SetDisplayShowCustomEnabled(Boolean)	Impostare se deve essere visualizzata una visualizzazione personalizzata, se impostata.
SetDisplayShowHomeEnabled(Boolean)	Impostare se includere l'offerta home dell'applicazione nella barra delle azioni.
SetDisplayShowTitleEnabled(Boolean)	Impostare se deve essere visualizzato un titolo o un sottotitolo attività.
SetDisplayUseLogoEnabled(Boolean)	Impostare se visualizzare il logo dell'attività anziché l'icona dell'attività.
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
SetHomeActionContentDescription(ICharSequence)	Impostare una descrizione alternativa per l'azione Home/Up, se abilitata.
SetHomeActionContentDescription(Int32)	Impostare una descrizione alternativa per l'azione Home/Up, se abilitata.
SetHomeActionContentDescription(String)	Impostare una descrizione alternativa per l'azione Home/Up, se abilitata.
SetHomeAsUpIndicator(Drawable)	Impostare un elemento di disegno alternativo da visualizzare accanto all'icona/logo/titolo quando #DISPLAY_HOME_AS_UP è abilitato.
SetHomeAsUpIndicator(Int32)	Impostare un elemento di disegno alternativo da visualizzare accanto all'icona/logo/titolo quando #DISPLAY_HOME_AS_UP è abilitato.
SetHomeButtonEnabled(Boolean)	Abilitare o disabilitare il pulsante "home" nell'angolo della barra delle azioni.
SetIcon(Drawable)	Impostare l'icona da visualizzare nella sezione "home" della barra delle azioni.
SetIcon(Int32)	Impostare l'icona da visualizzare nella sezione "home" della barra delle azioni.
SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener)	Obsoleti. Impostare l'adattatore e il callback di spostamento per la modalità di spostamento elenco.
SetLogo(Drawable)	Impostare il logo da visualizzare nella sezione "home" della barra delle azioni.
SetLogo(Int32)	Impostare il logo da visualizzare nella sezione "home" della barra delle azioni.
SetSelectedNavigationItem(Int32)	Obsoleti. Impostare l'elemento di spostamento selezionato in modalità di spostamento a schede o elenco.
SetSplitBackgroundDrawable(Drawable)	Impostare lo sfondo diviso di ActionBar.
SetStackedBackgroundDrawable(Drawable)	Impostare lo sfondo in pila di ActionBar.
SetSubtitle(Int32)	Impostare il sottotitolo della barra delle azioni.
SetTitle(Int32)	Impostare il titolo della barra delle azioni.
Show()	Mostra actionBar se non è attualmente visualizzato.
ToArray<T>()	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
ToString()	Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object)
UnregisterFromRuntime()	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
Wait()	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere eseguendo>una notifica</em o <em interrotto</>em>>.< (Ereditato da Object)
Wait(Int64)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64, Int32)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)

Eventi

MenuVisibility

Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
IJavaPeerable.Finalized()	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi. (Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione dei tipi controllati dal runtime Android.
JavaCast<TResult>(IJavaObject)	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.
GetJniTypeName(IJavaPeerable)	Barra degli strumenti primaria all'interno dell'attività che può visualizzare il titolo dell'attività, gli inviti di spostamento a livello di applicazione e altri elementi interattivi.