Identificativo articolo: 625066 - Ultima modifica: venerdì 20 gennaio 2006 - Revisione: 4.0

How to Come creare COM Add-ins per Outlook 2000

Questo articolo è stato precedentemente pubblicato con il codice di riferimento I16011
Espandi tutto | Chiudi tutto

Sommario

In Outlook 2000 e' possibile utilizzare delle Add-ins in modo da estendere le funzionalita' dell'applicazione stessa. Le Add-ins possono essere sviluppate sia con Visual Basic 6.0 che con Microsoft Office Developer 2000 (MOD2000). Lo scopo di questo articolo e' di fornire un Modello base dal quale iniziare a sviluppare le proprie Add-ins in ambiente Visual Basic 6.0. Il codice che sara' riportato nella sezione "Ulteriori Informazioni" potra' essere copiato ed incollato nel proprio progetto per implementare gli eventi supportati dalle Add-ins.

Informazioni

Per poter generare delle Add-in un progetto deve contenere come minimo:
  • un Add-in Designer. Oggetto che contiene la struttura necessaria all'Add-in per collegarsi ad una applicazione di Office (nel nostro caso ad Outlook). E' necessario definire in quest'oggetto a quale applicazione di Office l'Add-in si colleghera'.
  • Un riferimento all'oggetto IDTExtensibility2. Quest'oggetto permette di implementare e gestire gli eventi di connessione e/o disconnessione dell'Add-in all'applicazione di Office che la ospita. Questi eventi possono essere utilizzati anche per modificare eventuali Menu' o Command Bars in modo che l'Add-in sia attivabile solo quando l'utente la necessita.
Il modello per la creazione di Add-in contenuto in Visual Basic 6.0 non lavora perfettamente con le applicazioni di Office poiche' e' stato creato nell'ottica di fornire un punto di partenza per lo sviluppo di Add-ins per Visual Basic stesso. Questo articolo permette quindi di partire da quel modello e generarne uno valido per l'utilizzo con Outlook 2000.
  • eseguire Microsoft Visual Basic 6.0 e selezionare fra i modelli disponibili "Addin". Questo generera' un progetto che contiene una Form ed un oggetto Designer.
  • Rimuovere la form poiche' non rientra nello scopo di questo articolo
  • Visualizzare il codice associato all'oggetto Connect del Designer.
  • Selezionarlo completamente premendo CTRL-A e cancellare tutto.
  • A questo punto fare doppio click sull'oggetto Connect
  • Definire un nome ed una descrizione per l'Add-in
  • In "Application" selezionare "Microsoft Outlook"
  • Per questo specifico test selezionare in "Initial Load Behavior", "Startup" e quindi chiudere questa dialog box
  • Inserire nella prima linea di codice quanto segue:
    implements IDTExtensibility2
  • questo permette la creazione dell'oggetto IDTExtensibility2 che mette a disposizione dell'Add-in gli eventi che serviranno per gestirne la sua integrazione con Outlook.
  • Selezionare la Combobox sulla sinistra, quella in cui compare (General) e scegliere IDTExtensibility2, questo generera' automaticamente il codice che segue:
    Private Sub IDTExtensibility2_OnConnection(ByVal Application As Object, 
    ByVal ConnectMode As AddInDesignerObjects.ext_ConnectMode, ByVal AddInInst 
    As Object, custom() As Variant)
    
    End Sub
  • a questo punto selezionare la Combobox di destra, in cui dovrebbe comparire OnConnection e scegliere uno ad uno tutti gli eventi che compaiono nella lista di modo da generare la definizione delle procedure per la gestione di tutti e 5 gli eventi associati all'oggetto IDTExtensibility2.
  • In conclusione inseriremo una Message Box all'interno di ogni evento di modo che si possa evidenziare la sequenza degli eventi ed avere un'idea precisa di quando ogni singolo evento si verifica e di conseguenza decidere se gestire ed in che modo ogni evento. Il codice finale sara' quello che segue:
    Implements IDTExtensibility2
    
    Private Sub IDTExtensibility2_OnAddInsUpdate(custom() As Variant)
        MsgBox "Evento OnAddInsUpdate"
    End Sub
    
    Private Sub IDTExtensibility2_OnBeginShutdown(custom() As Variant)
        MsgBox "Evento OnBeginShutdown"
    End Sub
    
    Private Sub IDTExtensibility2_OnConnection(ByVal Application As Object, 
    ByVal ConnectMode As AddInDesignerObjects.ext_ConnectMode, ByVal AddInInst 
    As Object, custom() As Variant)
        MsgBox "Evento OnConnection"
    End Sub
    
    Private Sub IDTExtensibility2_OnDisconnection(ByVal RemoveMode As 
    AddInDesignerObjects.ext_DisconnectMode, custom() As Variant)
        MsgBox "Evento OnDisconnection"
    End Sub
    
    Private Sub IDTExtensibility2_OnStartupComplete(custom() As Variant)
        MsgBox "Evento OnStartupComplete"
    End Sub
  • ora e' possibile compilare l'Add-in e renderla quindi disponibile in Outlook 2000. Per raggiungere tale scopo selezionare il menu' "File" e quindi "Make MyAddin.dll.".
  • E' necessario uscire da Outlook e riavviarlo per rendere attiva l'Add-in appena creata, gia' all'avvio sara' possibile verificare l'attivita' della stessa poiche' inizieranno a comparire in sequenza le varie Message Boxes.
L'Add-in viene automaticamente registrata sulla macchina di sviluppo mentre e' necessario registrarla sulle macchine client che la necessiteranno. Quello che segue e' il comando che permette di registrare un'Add-in, deve essere lanciato da una sessione di Command Prompt:
%windir%\system32\regsvr32 MyAddin.DLL
nel comando qui sopra per "%windir%" si intende la directory in cui e' stato installato Windows (l'esempio si riferisce a Windows NT).

Riferimenti

MS PRESS : "Building Applications with Microsoft Outlook 2000" - Capitolo 13, by Randy Byrne

Le informazioni in questo articolo si applicano a
  • Microsoft Outlook 2000 Standard Edition
Chiavi: 
KB625066
LE INFORMAZIONI CONTENUTE NELLA MICROSOFT KNOWLEDGE BASE SONO FORNITE SENZA GARANZIA DI ALCUN TIPO, IMPLICITA OD ESPLICITA, COMPRESA QUELLA RIGUARDO ALLA COMMERCIALIZZAZIONE E/O COMPATIBILITA' IN IMPIEGHI PARTICOLARI. L'UTENTE SI ASSUME L'INTERA RESPONSABILITA' PER L'UTILIZZO DI QUESTE INFORMAZIONI. IN NESSUN CASO MICROSOFT CORPORATION E I SUOI FORNITORI SI RENDONO RESPONSABILI PER DANNI DIRETTI, INDIRETTI O ACCIDENTALI CHE POSSANO PROVOCARE PERDITA DI DENARO O DI DATI, ANCHE SE MICROSOFT O I SUOI FORNITORI FOSSERO STATI AVVISATI. IL DOCUMENTO PUO' ESSERE COPIATO E DISTRIBUITO ALLE SEGUENTI CONDIZIONI: 1) IL TESTO DEVE ESSERE COPIATO INTEGRALMENTE E TUTTE LE PAGINE DEVONO ESSERE INCLUSE. 2) I PROGRAMMI SE PRESENTI, DEVONO ESSERE COPIATI SENZA MODIFICHE, 3) IL DOCUMENTO DEVE ESSERE DISTRIBUITO INTERAMENTE IN OGNI SUA PARTE. 4) IL DOCUMENTO NON PUO' ESSERE DISTRIBUITO A SCOPO DI LUCRO.