Interfaccia ITaskbarList3 (shobjidl_core.h)
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.
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) |