Come trovare e utilizzare la documentazione di modello oggetto di Office

In questo articolo vengono descritti le risorse e i documenti che consentono di automatizzare le applicazioni di Microsoft Office. Le informazioni fornite possono essere utilizzate indipendentemente dal linguaggio di programmazione scelto per automatizzare l'applicazione di Office desiderata. Nell'articolo viene anche spiegato come iniziare a scrivere del codice di automazione guidando l'utente nella documentazione alla ricerca delle informazioni necessarie per compiere un'operazione specifica.

Dove è possibile reperire la documentazione sul modello di oggetti?

I modelli di oggetto per le applicazioni di Office sono documentati in un riferimenti di linguaggio per entrambe le versioni di Office: Microsoft Office 97 Visual Basic Language per applicazioni
ISBN 1-57231-339-0

Microsoft Office 2000 Visual Basic, Applications riferimenti del linguaggio
ISBN 1-57231-955-0.
I documenti "Language Reference", con riferimenti dei linguaggi di programmazione, sono disponibili su MSDN e nella Guida in linea dei prodotti Microsoft Office. nonché in versione stampata che è possibile acquistare. Per informazioni sulle modalità di ordinazione, visitare il seguente sito Web: Nella tabella che segue sono indicati i file della Guida di ogni applicazione di Office.



In base all'impostazione predefinita i file della Guida disponibili in Microsoft Office 97 sono installati nella cartella: Se non si riesce a reperire il file della Guida di VBA per Office 97 necessario, è possibile che non sia stato caricato durante l'installazione di Office 97. Per installarlo, eseguire il programma di installazione di Office e aggiungere il file della Guida di VBA. Si noti che con il programma di installazione di Office non viene caricato il file della Guida di VBA per Outlook 97. Per informazioni sull'installazione del file della Guida di VBA per Outlook 97, vedere il seguente articolo della Knowledge Base: I file della Guida forniti con Microsoft Office 2000 vengono installati per impostazione predefinita in: In base all'impostazione predefinita i file della Guida disponibili in Microsoft Office XP sono installati nella cartella: Nota : i programmi di Microsoft Office 2000, Microsoft Office XP e installazione di Microsoft Office 2003 installano i file di Guida di VBA "al"primo utilizzo. Di conseguenza, non sarà potrebbe visualizzare il file della Guida in questa directory se non si precedentemente tenta accedere la Guida di VBA nell'applicazione di Office.

Come è possibile utilizzare la documentazione sul modello di oggetti?

Esistono vari metodi per trovare della documentazione su una classe, un metodo o una proprietà specifici:

• Eseguire una ricerca nel file della Guida di VBA:
  
  In Visual Basic Editor per l'applicazione di Office scegliere Sommario e indice dal menu ? . Nella scheda Sommario selezionare il riferimento di linguaggio desiderato e scegliere Visualizza . Verrà visualizzata la Guida di VBA per i riferimenti del linguaggio selezionato. A questo punto, è possibile utilizzare sia sulla scheda Trova o l' indice per individuare informazioni su una classe specifica, metodo o proprietà.
• Utilizzare la Guida contestuale in un modulo o nel riquadro Immediata:
  
  In Visual Basic Editor per l'applicazione Office, digitare la classe, metodo o proprietà nella finestra del codice di un modulo o nella Finestra immediata , evidenziare il testo e premere il tasto F1. Verrà visualizzato l'argomento della Guida relativo alla voce desiderata.
• Utilizzare il Visualizzatore oggetti:
  
  Premere il tasto F2 in Visual Basic Editor per l'applicazione Office visualizzare il Visualizzatore oggetti . Il Visualizzatore oggetti Elenca tutte le classi che espone l'applicazione e i metodi o la proprietà associate a ciascuna classe. Per visualizzare la Guida di una classe o di un membro di classe specifici, selezionare l'elemento desiderato nel Visualizzatore oggetti e premere il tasto F1.

Come fare per sapere quali classi, metodi e proprietà utilizzare?

Se non si ha già una sufficiente dimestichezza con il modello di oggetti dell'applicazione che si desidera rendere automatica, è possibile utilizzare l'utilità di registrazione macro dell'applicazione per avere un'idea. È possibile iniziare con il registratore macro per illustrare, si supponga che si desidera automatizzare Microsoft Word per aggiungere testo a un documento nuovo e quindi salvare il documento ma non conosce quali metodi e proprietà da utilizzare:

1. Avviare Microsoft Word.
2. Scegliere macro dal menu Strumenti e quindi selezionare Registra nuova macro . Prendere nota del nome della macro e fare clic su OK per avviare la registrazione.
3. Creare un nuovo documento.
4. Digitare una e premere il tasto INVIO.
5. Digitare due e premere il tasto INVIO.
6. Digitare tre .
7. Fare clic su Salva dal menu file e salvare il documento come "C:\doc1.doc".
8. Fare clic sul pulsante Interrompi registrazione oppure scegliere macro dal menu Strumenti e selezionare Interrompi registrazione .
9. Per visualizzare il codice VBA che ha generato il registratore macro dalle azioni, scegliere macro dal menu Strumenti , quindi macro . Selezionare il nome della nuova macro nell'elenco e fare clic su Modifica . L'editor di Visual Basic viene visualizzato con la macro registrata:

    Documents.Add
    Selection.TypeText Text:="one"
    Selection.TypeParagraph
    Selection.TypeText Text:="two"
    Selection.TypeParagraph
    Selection.TypeText Text:="three"
    ActiveDocument.SaveAs FileName:="Doc1.doc", FileFormat:=wdFormatDocument,_
      LockComments:=False, Password:="", AddToRecentFiles:=True, _ 
      WritePassword:="", ReadOnlyRecommended:=False, _
      EmbedTrueTypeFonts:=False, SaveNativePictureFormat:=False, _
      SaveFormsData:=False, SaveAsAOCELetter:= False
   					

È molto utile capire il modo in cui ogni classe rientra nel modello di oggetti e apprendere la descrizione e il tipo di tutti i parametri dei metodi e delle proprietà utilizzati.

Iniziare con l'analisi della macro registrata prima riga: Documents.Add. Evidenziare documenti nel modulo codice per la macro registrata e premere il tasto F1. Nell'argomento della Guida visualizzato sono contenute informazioni importanti, riportate di seguito:

• La proprietà Documents restituisce un insieme Documents che rappresenta tutti i documenti aperti.
• La proprietà Documents si applica all'oggetto Application.

Tornare alla macro registrata, Aggiungi per evidenziare il modulo di codice e premere il tasto F1. Verrà visualizzato un argomento della Guida in cui si spiega che molti oggetti di diverso tipo dispongono di un metodo Add. Fare clic su documenti per vedere la Guida per il metodo Add dell'insieme Documents. Nell'argomento della Guida visualizzato sono contenute informazioni importanti, riportate di seguito:

• Il metodo Add aggiunge un nuovo documento vuoto all'insieme di documenti aperti.
• Il metodo Add può assumere due argomenti, entrambi facoltativi.

Esaminare ora alla riga successiva la macro registrata: Selection.TypeText Text: = "uno". Evidenziare la Selezione nel modulo di codice e premere il tasto F1:

• La proprietà Selection restituisce l'oggetto Selection che rappresenta una serie selezionata o il punto di inserimento.
• La proprietà"Selection si applica all'oggetto Application.

Tornare alla macro registrata, TypeText per evidenziare il modulo di codice e premere il tasto F1:

• Il metodo TypeText inserisce il testo specificato.
• Il metodo TypeText dispone di un argomento obbligatorio del tipo String.
• Il metodo TypeText si applica all'oggetto Selection.

Vedere quindi l'argomento della Guida per TypeParagraph :

• Il metodo TypeParagraph inserisce un nuovo paragrafo vuoto.
• Il metodo TypeParagraph si applica all'oggetto Selection e non dispone di argomenti.

Esaminare gli argomenti della Guida per la proprietà ActiveDocument e il metodo SaveAs :

• La proprietà ActiveDocument restituisce un oggetto Document che rappresenta il documento attivo. "ActiveDocument" applicata all'oggetto Application.
• Il metodo SaveAs salva il documento. In base alla versione di Word, questo metodo ha da 11 a 16 argomenti, solo uno dei quali è necessario. "SaveAs" si applica a un oggetto Document.

Si sarà notato che la proprietà Documents , proprietà Selection e proprietà ActiveDocument siano tutte le proprietà applicano all'oggetto Application , ma ancora non sono qualificate con "Applicazione" nella macro registrata. L'oggetto di applicazione è l'oggetto predefinito per tutte le proprietà e può pertanto essere omesso quando si scrive codice in una macro VBA. Ciò non è però vero durante la scrittura di codice di automazione, nel quale tutte le proprietà e tutti i metodi devono essere completi.

Al momento dell'analisi della macro registrata, è possibile vedere che il metodo SaveAs dispone di un argomento per il quale viene passato il costante incorporata wdFormatDocument . In funzione del linguaggio di programmazione scelto per il controller di automazione, potrebbe essere necessario passare il valore numerico delle costanti incorporate. Argomento della Guida per il metodo SaveAs non fornisce queste informazioni non è possibile trovare nel Visualizzatore oggetti . Premere il tasto F2 per visualizzare il Visualizzatore oggetti . Tipo:

wdFormatDocument

Nella finestra di ricerca e premere INVIO chiave. Nella riquadro inferiore del Visualizzatore oggetti , è possibile visualizzare l'equivalente numerico di wdFormatDocument(=0) nonché altre informazioni per la costante.

Dove è possibile reperire alcuni codici di esempio di automazione?

Le informazioni fornite in questo articolo costituiscono una buona base di partenza per la scrittura di codice di automazione. La Microsoft Knowledge Base è una risorsa eccellente per il reperimento di codici di esempio scritti in Visual Basic, Visual C++ e MFC. Di seguito ne sono elencati alcuni:

Per sviluppatori di Visual Basic

Per ulteriori informazioni, fare clic sui numeri degli articoli della Microsoft Knowledge Base riportato di seguito:

Sviluppatori di Visual C++ con MFC

Per ulteriori informazioni, fare clic sui numeri degli articoli della Microsoft Knowledge Base riportato di seguito:

Sviluppatori di C/C++ senza MFC

Per ulteriori informazioni, fare clic sui numeri degli articoli della Microsoft Knowledge Base riportato di seguito:

Sviluppatori di Visual J++

Per ulteriori informazioni, fare clic sui numeri degli articoli della Microsoft Knowledge Base riportato di seguito:

Sviluppatori di Visual FoxPro

Per ulteriori informazioni, fare clic sui numeri degli articoli della Microsoft Knowledge Base riportato di seguito: Per ulteriori informazioni, tra cui codice di esempio e risorse per l'automazione di Microsoft Office, visitare il sito Web Microsoft seguente (informazioni in lingua inglese):