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 l'impostazione predefinita. 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 Barra degli strumenti all'interno del layout dell'applicazione. L'applicazione può segnalare all'attività quale barra degli strumenti 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 in caso contrario non richiedere la funzionalità della finestra.

Modificando le funzionalità della finestra richieste dal tema e dai 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 una delle due configurazioni.

Quando si usano i temi Holo, la barra delle azioni mostra l'icona dell'applicazione a sinistra, seguita dal titolo dell'attività. Se l'attività include un menu di opzioni, è possibile rendere gli elementi selezionati accessibili direttamente dalla barra delle azioni come "elementi azione". È anche possibile modificare varie caratteristiche della barra delle azioni o rimuoverla completamente.

Quando si usano i temi materiali (impostazione predefinita nell'API 21 o versione successiva) il pulsante di spostamento (in precedenza "Home") acquisisce lo spazio occupato in precedenza dall'icona dell'applicazione. Le app che desiderano esprimere una personalizzazione più forte devono usare i colori del marchio pesantemente nella barra delle azioni e in 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 abilita le azioni contestuali, usando un oggetto android.view.ActionMode. Ad esempio, quando l'utente seleziona uno o più elementi nell'attività, puoi 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 Guides</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 basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

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. -oppure- Impostare l'elevazione dell'asse Z della barra delle azioni in pixel.
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
Height	Recuperare l'altezza corrente della barra delle azioni.
HideOffset	Restituisce l'offset verticale corrente della barra delle azioni. -oppure- Imposta l'offset nascondi corrente della barra delle azioni.
HideOnContentScrollEnabled	Restituisce un valore che indica se la barra delle azioni è configurata per lo scorrimento fuori visualizzazione insieme a un oggetto View#setNestedScrollingEnabled(boolean) nested scrolling child. -oppure- Abilita 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	Ottiene 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	Ottiene 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 Context oggetto 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 la barra delle azioni se è attualmente visualizzata.
JavaFinalize()	Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object)
NewTab()	Obsoleti. Creare e restituire un nuovo ActionBar.Taboggetto .
Notify()	Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitor 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 della barra delle azioni.
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)	Consente di specificare se la casa deve essere visualizzata come invito "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'invito home dell'applicazione nella barra delle azioni.
SetDisplayShowTitleEnabled(Boolean)	Consente di specificare se deve essere visualizzato un titolo o un sottotitolo dell'attività.
SetDisplayUseLogoEnabled(Boolean)	Impostare se visualizzare il logo 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 disegnabile alternativo da visualizzare accanto all'icona, al logo o al titolo quando #DISPLAY_HOME_AS_UP è abilitato.
SetHomeAsUpIndicator(Int32)	Impostare un elemento disegnabile alternativo da visualizzare accanto all'icona, al logo o al 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 navigazione 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 nelle modalità di spostamento a schede o nell'elenco.
SetSplitBackgroundDrawable(Drawable)	Impostare lo sfondo diviso della barra delle azioni.
SetStackedBackgroundDrawable(Drawable)	Impostare lo sfondo in pila della barra delle azioni.
SetSubtitle(Int32)	Impostare il sottotitolo della barra delle azioni.
SetTitle(Int32)	Impostare il titolo della barra delle azioni.
Show()	Mostra la barra delle azioni se non è attualmente visualizzata.
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 di 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()	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object)
Wait(Int64)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< 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)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< 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 del tipo di tipo controllato 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.