Interfaccia ITaskbarList3 (shobjidl_core.h)

  • Articolo

Estende ITaskbarList2 esponendo i metodi che supportano l'avvio unificato e la funzionalità del pulsante della barra delle applicazioni aggiunta in Windows 7. Questa funzionalità include rappresentazioni di anteprima e destinazioni switch basate su singole schede in un'applicazione a schede, barre degli strumenti di anteprima, sovrimpressioni di notifica e stato e indicatori di stato.

Ereditarietà

L'interfaccia ITaskbarList3 eredita da ITaskbarList2. ITaskbarList3 include anche questi tipi di membri:

Metodi

L'interfaccia ITaskbarList3 include questi metodi.

 
ITaskbarList3::RegisterTab

Informa la barra delle applicazioni che è stata fornita una nuova scheda o un'anteprima del documento per la visualizzazione nel riquadro a comparsa del gruppo della barra delle applicazioni di un'applicazione.
ITaskbarList3::SetOverlayIcon

Applica una sovrimpressione a un pulsante della barra delle applicazioni per indicare lo stato dell'applicazione o una notifica all'utente.
ITaskbarList3::SetProgressState

Imposta il tipo e lo stato dell'indicatore di stato visualizzato su un pulsante della barra delle applicazioni.
ITaskbarList3::SetProgressValue

Visualizza o aggiorna un indicatore di stato ospitato in un pulsante della barra delle applicazioni per visualizzare la percentuale specifica completata dell'operazione completa.
ITaskbarList3::SetTabActive

Informa la barra delle applicazioni che una scheda o una finestra del documento è stata attivata.
ITaskbarList3::SetTabOrder

Inserisce una nuova anteprima in un riquadro a comparsa di un'interfaccia a documenti a schede (TDI) o nel riquadro a comparsa del gruppo di applicazioni a documenti multipli o sposta un'anteprima esistente in una nuova posizione nel gruppo dell'applicazione.
ITaskbarList3::SetThumbnailClip

Seleziona una parte dell'area client di una finestra da visualizzare come anteprima della finestra nella barra delle applicazioni.
ITaskbarList3::SetThumbnailTooltip

Specifica o aggiorna il testo della descrizione comando visualizzata quando il puntatore del mouse si posiziona su una singola anteprima in un riquadro a comparsa del pulsante della barra delle applicazioni.
ITaskbarList3::ThumbBarAddButtons

Aggiunge una barra degli strumenti di anteprima con un set specificato di pulsanti all'immagine di anteprima di una finestra in un riquadro a comparsa del pulsante della barra delle applicazioni.
ITaskbarList3::ThumbBarSetImageList

Specifica un elenco di immagini che contiene immagini pulsante per una barra degli strumenti incorporata in un'immagine di anteprima di una finestra in un riquadro a comparsa del pulsante della barra delle applicazioni.
ITaskbarList3::ThumbBarUpdateButtons

Mostra, abilita, disabilita o nasconde i pulsanti in una barra degli strumenti di anteprima come richiesto dallo stato corrente della finestra. Una barra degli strumenti di anteprima è una barra degli strumenti incorporata in un'immagine di anteprima di una finestra in un riquadro a comparsa del pulsante della barra delle applicazioni.
ITaskbarList3::UnregisterTab

Rimuove un'anteprima dal gruppo di anteprima di un'applicazione quando tale scheda o documento viene chiuso nell'applicazione.

Commenti

Questa interfaccia fornisce anche i metodi delle interfacce ITaskbarList e ITaskbarList2 , da cui eredita.

Quando implementare

Un'implementazione di questa interfaccia viene fornita in Windows come CLSID_TaskbarList. Questa interfaccia non è implementata da terze parti.

Quando usare

Usare i metodi di questa interfaccia per eseguire le operazioni seguenti:
  • Quando si usa un'applicazione TDI (ad esempio Windows Internet Explorer) o un'applicazione MDI (ad esempio Microsoft Excel) che visualizza le finestre come gruppo sulla barra delle applicazioni:
    • Fornire alla barra delle applicazioni un'anteprima che rappresenta la visualizzazione di una singola scheda o documento.
    • Rimuovere l'anteprima di una singola scheda o documento dal gruppo.
    • Modificare l'ordine delle anteprime nel gruppo.
    • Impostare un'anteprima della scheda come elemento selezionato quando vengono visualizzate le anteprime.
  • Quando si applica una sovrimpressione a un'icona della barra delle applicazioni, ad esempio una notifica.
  • Quando viene visualizzato lo stato di avanzamento di un'operazione, ad esempio la copia o l'installazione di un elemento.
  • Quando si aggiunge una barra degli strumenti a un'anteprima.
Quando un'applicazione visualizza una finestra, il pulsante della barra delle applicazioni viene creato dal sistema. Quando il pulsante è posizionato, la barra delle applicazioni invia un messaggio TaskbarButtonCreated alla finestra. L'applicazione deve chiamare RegisterWindowMessage(L"TaskbarButtonCreated") e gestire il messaggio nel relativo wndproc. Tale messaggio deve essere ricevuto dall'applicazione prima di chiamare qualsiasi metodo ITaskbarList3 .
Nota Le applicazioni non possono essere aggiunte a livello di codice alla barra delle applicazioni. Tale funzionalità è riservata esclusivamente all'utente.
 

Requisiti

   
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)

Vedi anche

ITaskbarList2

Estensioni della barra delle applicazioni