Esempio di evento Click

In questo esempio viene illustrata la modalità di impostazione del codice per una routine di eventi Click mediante l'utilizzo di WithEvents e Set. Si noti che per il nome dell'evento Click viene utilizzato il riferimento all'oggetto ce anziché il nome del menu Strumenti.

Private WithEvents ce As CommandBarEvents

Sub Test()

    Dim c As CommandBarControl

    Set c = Application.VBE.CommandBars("Strumenti").Controls(1)

    Set ce = Application.VBE.Events.CommandBarEvents(c)

End Sub

Private Sub ce_Click(ByVal CommandBarControl As Object, Handled As Boolean, CancelDefault As Boolean)

    ' Inserire qui il codice per la gestione dell'evento

End Sub


Evento Click

Viene generato quando si imposta la proprietà OnAction di un controllo della barra di comando corrispondente.

Sintassi

Sub oggetto_Click (ByVal ctrl As Object, ByRef handled As Boolean, ByRef canceldefault As Boolean)

La sintassi dell'evento Click è composta dai seguenti argomenti predefiniti:

Parte	Descrizione
ctrl	Obbligatoria. Tipo di dati Object. Specifica l'oggetto che rappresenta l'origine dell'evento Click.
handled	Obbligatoria. Valore Boolean. Se è True, l'evento dovrà essere gestito da altre aggiunte (add-in). Se è False, l'azione dell'elemento della barra di comando non è stata gestita.
canceldefault	Obbligatoria. Valore Boolean. Se è True, viene eseguito il funzionamento predefinito, a meno che esso non venga annullato da un'aggiunta successiva. Se è False, non viene eseguito il funzionamento predefinito a meno che esso non venga ripristinato da un'aggiunta successiva.
Osservazioni

L'evento Click è specifico dell'oggetto CommandBarEvents. Utilizzare una variabile dichiarata utilizzando la parola chiave WithEvents per ricevere l'evento Click per un controllo CommandBar. È consigliabile impostare questa variabile sul valore restituito dalla proprietà CommandBarEvents dell'oggetto Events. La proprietà CommandBarEvents include il controllo CommandBar come argomento. Quando si fa clic sul controllo CommandBar (per la variabile dichiarata utilizzando la parola chiave WithEvents), verrà eseguito il codice.


Evento ItemAdded

Viene generato dopo che è stato aggiunto un riferimento.

Sintassi

Sub oggetto_ItemAdded(ByVal item As Reference)

L'argomento obbligatorio item specifica l'elemento che è stato aggiunto.

Osservazioni

L'evento ItemAdded viene generato quando un oggetto Reference viene aggiunto all'insieme References.


Evento ItemRemoved

Viene generato quando un riferimento viene rimosso da un progetto.

Sintassi

Sub oggetto_ItemRemoved(ByVal item As Reference)

L'argomento obbligatorio item specifica l'oggetto Reference che è stato rimosso.


Metodo Add (modello di oggetti aggiunte VBA)

Aggiunge un oggetto a un insieme.

Sintassi

oggetto.Add(componente)

La sintassi del metodo Add è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
componente	Obbligatoria. Per l'insieme LinkedWindows, un oggetto. Per l'insieme VBComponents, una costante enumerata che rappresenta un modulo di classe, un form o un modulo standard. Per l'insieme VBProjects, una costante enumerata che rappresenta il tipo di progetto.
Per l'argomento componente è possibile utilizzare una delle seguenti costanti:

Costante	Descrizione
vbext_ct_ClassModule	Aggiunge un modulo di classe all'insieme.
vbext_ct_MSForm	Aggiunge un form all'insieme.
vbext_ct_StdModule	Aggiunge un modulo standard all'insieme.
vbext_pt_StandAlone	Aggiunge un progetto autonomo all'insieme.
Osservazioni

Per l'insieme LinkedWindows, il metodo Add aggiunge una finestra all'insieme corrente di finestre collegate.

Nota   È possibile aggiungere una finestra che è un riquadro di una cornice di finestre collegate a un'altra cornice di finestre collegate. La finestra verrà semplicemente spostata da un riquadro all'altro. Se la cornice di finestre collegate da cui è stata spostata la finestra non contiene più riquadri, verrà eliminata.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.

Per l'insieme VBComponents, il metodo Add crea un nuovo componente standard e lo aggiunge al progetto.

Per l'insieme VBComponents, il metodo Add restituisce un oggetto VBComponent. Per l'insieme LinkedWindows, il metodo Add restituisce Nothing.

Per l'insieme VBProjects, il metodo Add restituisce un oggetto VBProject e aggiunge un progetto all'insieme VBProjects.


Metodo AddFromFile

Per l'insieme References, aggiunge un riferimento a un progetto prelevandolo da un file. Per l'oggetto CodeModule, aggiunge il contenuto di un file a un modulo.

Sintassi

oggetto.AddFromFile(nomefile)

La sintassi del metodo AddFromFile è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomefile	Obbligatoria. Espressione stringa che specifica il nome del file che si desidera aggiungere al progetto o al modulo. Se il nome del file non viene trovato e non è specificato un percorso, la ricerca verrà eseguita nelle stesse directory in cui viene eseguita la funzione OpenFile di Windows.
Osservazioni

Per l'oggetto CodeModule, il metodo AddFromFile inserisce il contenuto di un file a partire dalla riga che precede la prima routine nel modulo di codice. Se il modulo non contiene routine, il metodo AddFromFile posizionerà il contenuto del file alla fine del modulo.


Metodo AddCustom

Restituisce un oggetto VBComponent oppure crea un nuovo componente personalizzato e lo aggiunge nel progetto.

Sintassi

oggetto.AddCustom (ByVal IDProg As String) As VBComponent

La sintassi del metodo AddCustom è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
IDProg	Obbligatoria. ID programmatico del componente personalizzato da creare.


Metodo AddFromGuid

Aggiunge un riferimento all'insieme References tramite l'identificatore univoco globale (GUID) del riferimento.

Sintassi

oggetto.AddFromGuid(guid, principale, secondario) As Reference

La sintassi del metodo AddFromGuid è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
guid	Obbligatoria. Espressione stringa che rappresenta l'identificatore univoco globale del riferimento.
principale	Obbligatoria. Valore Long che specifica il numero della versione principale del riferimento.
secondario	Obbligatoria. Valore Long che specifica il numero della versione secondaria del riferimento.
Osservazioni

Il metodo AddFromGuid esegue la ricerca del riferimento che si desidera aggiungere nel registro di configurazione. Il GUID può essere una libreria dei tipi, un controllo, un identificatore di classe e così via.


Metodo AddFromString

Aggiunge testo a un modulo.

Sintassi

oggetto.AddFromString

Il segnaposto oggetto è un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".

Osservazioni

Il metodo AddFromString inserisce il testo a partire dalla riga che precede la prima routine nel modulo. Se il modulo non include routine, il testo verrà posizionato alla fine del modulo.


Metodo Close (modello di oggetti aggiunte VBA)

Chiude ed elimina una finestra.

Sintassi

oggetto.Close

Il segnaposto oggetto è un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".

Osservazioni

I seguenti tipi di finestre rispondono in modi diversi al metodo Close:

•	Per una finestra che è un riquadro del codice, il metodo Close elimina il riquadro del codice.

•	Per una finestra che è una finestra di progettazione, il metodo Close elimina la finestra di progettazione inclusa.

•	Per le finestre che sono sempre disponibili nel menu Visualizza, il metodo Close nasconde la finestra.


Metodo CreateEventProc

Crea una routine di eventi.

Sintassi

oggetto.CreateEventProc(nomeevento, nomeoggetto) As Long

La sintassi del metodo CreateEventProc è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomeevento	Obbligatoria. Espressione stringa che specifica il nome dell'evento che si desidera aggiungere al modulo.
nomeoggetto	Obbligatoria. Espressione stringa che specifica il nome dell'oggetto che è l'origine dell'evento.
Osservazioni

Utilizzare il metodo CreateEventProc per creare una routine di eventi. Per creare, ad esempio, una routine di eventi per l'evento Click di un controllo CommandButton denominato Command1, è possibile utilizzare il codice seguente, dove CM rappresenta un oggetto del tipo CodeModule:

TextLocation = CM.CreateEventProc("Click", "Command1")

Il metodo CreateEventProc restituisce la riga in cui ha inizio la routine di eventi e ha esito negativo se gli argomenti fanno riferimento a un evento che non esiste.


Metodo CreateToolWindow

Consente di creare una nuova finestra degli strumenti contenente l'oggetto UserDocument specificato.

Sintassi

oggetto.CreateToolWindow (IstAggiunta, IDProg, Disdascalia, PosizioneGuid, OggDocj) As Window

La sintassi del metodo CreateToolWindow è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
IstAggiunta	Obbligatoria. Variabile di un'istanza di aggiunta che rappresenta un'aggiunta nell'ambiente di sviluppo.
IDProg	Obbligatoria. Stringa che rappresenta l'ID programmatico dell'oggetto UserDocument.
Disdascalia	Obbligatoria. Stringa che specifica la didascalia della finestra.
PosizioneGuid	Obbligatoria. Stringa che specifica un identificatore univoco per la finestra.
OggDocj	Obbligatoria. Oggetto che rappresenta un oggetto UserDocument. Viene impostato nella chiamata a questo metodo.


Metodo DeleteLines

Elimina una riga singola o l'intervallo di righe specificato.

Sintassi

oggetto.DeleteLines (rigainizio [, conteggio])

La sintassi del metodo DeleteLines è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
rigainizio	Obbligatoria. Valore Long che specifica la prima riga che si desidera eliminare.
conteggio	Facoltativa. Valore Long che specifica il numero di righe che si desidera eliminare.
Osservazioni

Se non viene specificato il numero di righe che si desidera eliminare, ne verrà eliminata una.


Metodo DesignerWindow

Restituisce l'oggetto Window che rappresenta la finestra di progettazione del componente.

Sintassi

oggetto.DesignerWindow

Il segnaposto oggetto è un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".

Osservazioni

Se il componente supporta una finestra di progettazione ma non sono aperte finestre di progettazione, è possibile utilizzare il metodo DesignerWindow per creare una finestra di progettazione non visibile e quindi renderla visibile impostando la proprietà Visible dell'oggetto Window su True.


Metodo Export (modello di oggetti aggiunte VBA)

Salva un componente come uno o più file distinti.

Sintassi

oggetto.Export(nomefile)

La sintassi del metodo Export è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomefile	Obbligatoria. Valore String che specifica il nome del file in cui si desidera esportare il componente.
Osservazioni

Se si utilizza il metodo Export per salvare un componente come uno o più file distinti, utilizzare un nome di file non esistente, altrimenti verrà generato un errore.


Metodo Find (modello di oggetti aggiunte VBA)

Esegue la ricerca della stringa specificata nel modulo attivo.

Sintassi

oggetto.Find(destinazione, rigainizio, colonnainizio, rigafine, colonnafine [, parolaintera] [, maiuscminusc] [, criterioricerca]) As Boolean

La sintassi del metodo Find è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
destinazione	Obbligatoria. Valore String contenente il testo o il criterio di cui si desidera eseguire la ricerca.
rigainizio	Obbligatoria. Valore Long che specifica la riga dalla quale si desidera iniziare la ricerca. Verrà impostata sulla riga dell'eventuale corrispondenza trovata. La prima riga corrisponde al numero 1.
colonnainizio	Obbligatoria. Valore Long che specifica la colonna a partire dalla quale viene eseguita la ricerca. Verrà impostata sulla colonna dell'eventuale corrispondenza trovata. La prima colonna corrisponde al numero 1.
rigafine	Obbligatoria. Valore Long che specifica l'ultima riga dell'eventuale corrispondenza trovata. L'ultima riga può essere specificata come -1.
colonnafine	Obbligatoria. Valore Long che specifica l'ultima riga dell'eventuale corrispondenza trovata. L'ultima colonna può essere specificata come -1.
parolaintera	Facoltativa. Valore Boolean che specifica se deve essere eseguita solo la ricerca di corrispondenze di parole intere. Se il valore impostato è True, verranno ricercate solo le corrispondenze di parole intere. Il valore predefinito è False.
maiuscminusc	Facoltativa. Valore Boolean che specifica se deve essere eseguita la ricerca di corrispondenze di maiuscole e minuscole. Se il valore impostato è True, la ricerca verrà eseguita in base alla corrispondenza di maiuscole e minuscole. Il valore predefinito è False.
criterioricerca	Facoltativa. Valore Boolean che specifica se la stringa di destinazione è un criterio di espressione standard. Se il valore impostato è True, la stringa di destinazione è un criterio di espressione standard. Il valore predefinito è False.
Osservazioni

Il metodo Find restituisce True se viene trovata una corrispondenza e False se non viene trovata una corrispondenza.

Gli argomenti maiuscminusc e criterioricerca si escludono a vicenda. Se entrambi gli argomenti vengono passati come True, verrà generato un errore.

Il metodo Find non influisce sul contenuto della finestra di dialogo Trova.

Gli estremi dell'intervallo di righe e colonne sono compresi, quindi le ricerche consentono di trovare il criterio nell'ultima riga specificata se per colonnafine viene impostato –1 o la lunghezza della riga.


Metodo GetSelection

Restituisce la selezione in un riquadro del codice.

Sintassi

oggetto.GetSelection(rigainizio, colonnainizio, rigafine, colonnafine)

La sintassi del metodo GetSelection è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
rigainizio	Obbligatoria. Valore Long che restituisce un valore che specifica la prima riga della selezione nel riquadro del codice.
colonnainizio	Obbligatoria. Valore Long che restituisce un valore che specifica la prima colonna della selezione nel riquadro del codice.
rigafine	Obbligatoria. Valore Long che restituisce un valore che specifica l'ultima riga della selezione nel riquadro del codice.
colonnafine	Obbligatoria. Valore Long che restituisce un valore che specifica l'ultima colonna della selezione nel riquadro del codice.
Osservazioni

Quando viene utilizzato il metodo GetSelection, le informazioni vengono restituite in argomenti di output. Di conseguenza, è necessario passare variabili poiché le variabili verranno modificate in modo da contenere le informazioni restituite.


Metodo Import (modello di oggetti aggiunte VBA)

Aggiunge un componente a un progetto prelevandolo da un file e restituisce il nuovo componente aggiunto.

Sintassi

oggetto.Import(nomefile) As VBComponent

La sintassi del metodo Import è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomefile	Obbligatoria. Valore String che specifica il percorso e il nome del file del componente che si desidera importare.
Osservazioni

È possibile utilizzare il metodo Import per aggiungere un componente, un form, un modulo, una classe e altri elementi al progetto.


Metodo InsertLines

Inserisce una o più righe di codice nella posizione specificata all'interno di un blocco di codice.

Sintassi

oggetto.InsertLines(riga, codice)

La sintassi del metodo InsertLines è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
riga	Obbligatoria. Valore Long che specifica la posizione in cui si desidera inserire il codice.
codice	Obbligatoria. Valore String contenente il codice che si desidera inserire.
Osservazioni

Se il testo inserito utilizzando il metodo InsertLines è delimitato da sequenze di ritorni a capo/avanzamenti di riga, verrà inserito sotto forma di righe consecutive.


Metodo Item (modello di oggetti aggiunte VBA)

Restituisce un membro specifico di un insieme.

Sintassi

oggetto.Item(indice)

La sintassi del metodo Item è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
indice	Obbligatoria. Espressione che specifica la posizione di un membro dell'insieme. Se è un'espressione numerica, indice deve essere un numero compreso tra 1 e il valore della proprietà Count dell'insieme. Se è un'espressione stringa, indice deve corrispondere all'argomento key specificato quando il membro è stato aggiunto all'insieme.
Nella tabella seguente viene fornito un elenco degli insiemi e dei relativi argomenti key da utilizzare con il metodo Item. La stringa passata al metodo Item deve corrispondere all'argomento key dell'insieme.

Insieme	Argomento Key
Windows	Impostazione della proprietà Caption
LinkedWindows	Impostazione della proprietà Caption
CodePanes	Nessuna stringa univoca è associata a questo insieme.
VBProjects	Impostazione della proprietà Name
VBComponents	Impostazione della proprietà Name
References	Impostazione della proprietà Name
Properties	Impostazione della proprietà Name
Osservazioni

L'argomento indice può essere un valore numerico o una stringa contenente il titolo dell'oggetto.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Metodo InsertFile

Inserisce codice da un file in un modulo di codice.

oggetto.InsertFile(nomefile) As String

La sintassi del metodo InsertFile è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomefile	Obbligatoria. Valore String che specifica il file contenente il codice da inserire nel modulo di codice.


Metodo Remove (modello di oggetti aggiunte VBA)

Rimuove un elemento da un insieme.

Sintassi

oggetto.Remove(componente)

La sintassi del metodo Remove è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
componente	Obbligatoria. Per l'insieme LinkedWindows rappresenta un oggetto. Per l'insieme References, rappresenta un riferimento a una libreria dei tipi o a un progetto. Per l'insieme VBComponents, è una costante enumerata che rappresenta un modulo di classe, un form o un modulo standard. Per l'insieme VBProjects, un progetto autonomo.
Osservazioni

Per l'insieme LinkedWindows, il metodo Remove rimuove una finestra dall'insieme corrente di finestre collegate. La finestra rimossa diventa una finestra mobile con una propria cornice di finestre collegate. È possibile utilizzare il metodo Remove soltanto in un progetto autonomo. Nei progetti host infatti viene generato un errore di run-time.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Metodo ReplaceLine

Sostituisce una riga di codice esistente con la riga di codice specificata.

Sintassi

oggetto.ReplaceLine(riga, codice)

La sintassi del metodo ReplaceLine è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
riga	Obbligatoria. Valore Long che specifica la posizione della riga che si desidera sostituire.
codice	Obbligatoria. Valore String contenente il codice che si desidera inserire.


Metodo MakeCompiledFile

Scrive il progetto corrente come DLL. Il nome del file è specificato nella proprietà BuildFileName.

Sintassi

oggetto.MakeCompiledFile

Il segnaposto oggetto è un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".


Metodo SetFocus

Sposta lo stato attivo sulla finestra specificata.

Sintassi

oggetto.SetFocus

Il segnaposto oggetto è un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".

Osservazioni

Utilizzare il metodo SetFocus per le finestre che sono già visibili.


Metodo SaveAs

Consente di salvare un progetto con un nuovo nome di file in una posizione specifica.

Sintassi

oggetto.SaveAs (nuovonomefile As String)

La sintassi del metodo SaveAs è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nuovonomefile	Obbligatoria. Espressione stringa che specifica il nuovo nome di file con cui salvare il componente.
Osservazioni

Se non si specifica un nuovo percorso, verrà utilizzato il percorso precedente. Se il nuovo nome di file non è valido oppure corrisponde a un file di sola lettura, verrà generato un errore.

È possibile utilizzare il metodo SaveAs soltanto in progetti autonomo. In progetti host infatti genera un errore di run-time.


Metodo SetSelection

Imposta la selezione nel riquadro del codice.

Sintassi

oggetto.SetSelection(rigainizio, colonnainizio, rigafine, colonnafine)

La sintassi del metodo SetSelection è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
rigainizio	Obbligatoria. Valore Long che specifica la prima riga della selezione.
colonnainizio	Obbligatoria. Valore Long che specifica la prima colonna della selezione.
rigafine	Obbligatoria. Valore Long che specifica l'ultima riga della selezione.
colonnafine	Obbligatoria. Valore Long che specifica l'ultima colonna della selezione.


Metodo Show (modello di oggetti aggiunte VBA)

Rende il riquadro del codice specificato visibile all'interno della relativa finestra.

Sintassi

oggetto.Show

Il segnaposto oggetto è un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".

Osservazioni

Il metodo Show assegna al riquadro del codice specificato lo stato attivo all'interno della relativa finestra.


Metodo Update

Consente di aggiornare il contenuto dell'insieme AddIns in base alle aggiunte elencate nel file Vbaddin.ini, esattamente come quando l'utente visualizza la finestra di dialogo Gestione aggiunte.

Sintassi

oggetto.Update

Il segnaposto oggetto è un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".

Osservazione

In Visual Basic è possibile utilizzare le aggiunte elencate nel file Vbaddin.ini soltanto se sono componenti ActiveX registrati nel registro di configurazione.


Esempio di metodo Add

In questo esempio il metodo Add viene utilizzato per aggiungere un modulo standard all'insieme VBComponents.

Application.VBE.VBProjects(1).VBComponents.Add(vbext_ct_StdModule)


Esempio di metodo AddFromFile

In questo esempio il metodo AddFromFile viene utilizzato per aggiungere il contenuto di un file al riquadro del codice specificato.

Application.VBE.CodePanes(3).CodeModule.AddFromFile "c:\File codice\libro2.frm"


Esempio di metodo AddFromGUID

In questo esempio il metodo AddFromGUID viene utilizzato per aggiungere un riferimento al progetto corrente, identificato tramite l'identificatore univoco globale dell'oggetto Reference.

Application.VBE.ActiveVBProject.References.AddFromGuid("{000204EF-0000-0000-C000-000000000046}", 5, 0)


Esempio di metodo AddFromString

In questo esempio il metodo AddFromString viene utilizzato per aggiungere una riga "Dim intJack As Integer" nel riquadro del codice specificato.

Application.VBE.CodePanes(3).CodeModule.AddFromString "Dim intJack As Integer"


Esempio di metodo Close

In questo esempio il metodo Close viene utilizzato per chiudere il membro specificato dell'insieme Windows.

Application.VBE.Windows(9).Close


Esempio di metodo CreateEventProc

In questo esempio il metodo CreateEventProc viene utilizzato per creare la routine Button_Click.

Debug.Print Application.VBE.SelectVBComponents.CodeModule.CreateEventProc("Click", "Button")


Esempio di metodo DeleteLines

L'esempio seguente include due passaggi. Nel primo ciclo For…Next, il metodo InsertLines viene utilizzato per inserire in CodePanes(1) 26 segmenti iniziali sempre più lunghi dell'alfabeto, a partire da "a". L'ultima riga inserita corrisponde all'intero alfabeto.

Nel secondo ciclo For…Next, il metodo DeleteLines viene utilizzato per eliminare le righe a numerazione dispari. Sebbene il secondo ciclo sembri eliminare semplicemente tutte le righe rimanenti, si noti che dopo ciascuna eliminazione le righe vengono rinumerate. L'eliminazione avanza quindi di due righe per ciascun passaggio, una riga poiché I aumenta di uno e un'altra riga poiché i numeri di riga maggiori vengono diminuiti di uno.

For I = 1 to 26

Application.VBE.SelectedVBComponent.CodeModule.InsertLines i, Mid$("abcdefghijklmnopqrstuvwxyz", 1, I)

Next

For I = 1 to 13

Application.VBE.SelectedVBComponent.CodeModule.DeleteLines I

Next


Esempio di metodo DesignerWindow

In questo esempio il metodo DesignerWindow e la proprietà Visible vengono utilizzati per verificare se una finestra di progettazione specifica è visibile o meno. Si noti che l'oggetto VBComponent deve essere un form.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).DesignerWindow.Visible


Esempio di metodo Export

In questo esempio viene creato un file denominato prova.bas e il metodo Export viene utilizzato per copiare in tale file il contenuto del modulo di codice VBComponents(1).

Application.VBE.ActiveVBProject.VBComponents(1).Export("prova.bas")


Esempio di metodo Find

In questo esempio il metodo Find viene utilizzato per verificare che il blocco di righe specificato, ovvero le righe dal numero 1261 al numero 1279, di un determinato riquadro del codice contenga la stringa "Tabs.Clear".

Application.VBE.CodePanes(2).CodeModule.Find ("Tabs.Clear", 1261, 1, 1280, 1, False, False)


Esempio di metodo GetSelection

In questo esempio vengono restituite le posizioni dei punti iniziali e finali della selezione corrente in CodePanes(1). Nell'ultima riga dell'esempio, il metodo GetSelection viene utilizzato per posizionare i quattro valori nelle quattro variabili.

Dim m As Long

Dim n As Long

Dim x As Long

Dim y As Long

Application.VBE.CodePanes(1).GetSelection m, n, x, y


Esempio di metodo Import

In questo esempio il metodo Import viene utilizzato per l'insieme VBComponents per copiare il contenuto del file prova.bas in un modulo di codice.

Application.VBE.ActiveVBProject.VBComponents.Import("prova.bas")


Esempio di metodo InsertLines

In questo esempio il metodo InsertLines viene utilizzato per inserire una riga, "Option Explicit", nel riquadro del codice specificato.

Application.VBE.CodePanes(1).CodeModule.InsertLines 1, "Option Explicit"


Esempio di metodo Item

In questo esempio vengono illustrati due metodi per visualizzare un membro specifico dell'insieme CodePanes, in uno dei quali è previsto l'utilizzo del metodo Item.

Application.VBE.CodePanes.Item(2).Show

Application.VBE.CodePanes(2).Show


Esempio di metodo Lines

In questo esempio il metodo Lines viene utilizzato per restituire in un determinato riquadro del codice un blocco del codice specifico, ovvero dalla riga 1 alla riga 4.

Debug.Print Application.VBE.CodePanes(1).CodeModule.Lines( 1, 4)


Esempio di metodo Remove

In questo esempio viene verificato se un membro specifico dell'insieme VBComponents è un modulo e quindi il metodo Remove viene utilizzato per rimuovere il modulo.

Debug.Print Application.VBE.ActiveVBProject.VBComponents(4).Name

Application.VBE.ActiveVBProject.VBComponents.Remove Application.VBE.ActiveVBProject.VBComponents(4)


Esempio di metodo ReplaceLine

L'esempio seguente include due passaggi. Nel primo ciclo For…Next, il metodo InsertLines viene utilizzato per inserire in CodePanes(1) 26 segmenti iniziali sempre più lunghi dell'alfabeto, a partire da "a". L'ultima riga inserita corrisponde all'intero alfabeto.

Nel secondo ciclo For…Next, il metodo ReplaceLine viene utilizzato per sostituire a ciascuna riga con numero pari l'ultima lettera nella stringa che occupava in precedenza tale riga. Le righe con numeri dispari rimangono invariate.

For I = 1 to 26

Application.VBE.CodePanes(1).CodeModule.InsertLines I, Mid$("abcdefghijklmnopqrstuvwxyz", 1, I)

Next I

For I = 1 to 13

Application.VBE.CodePanes(1).CodeModule.ReplaceLine 2*I, Mid$("abcdefghijklmnopqrstuvwxyz", 1, I)

Next I


Esempio di metodo SetFocus

In questo esempio il metodo SetFocus viene utilizzato per spostare lo stato attivo su un membro specifico dell'insieme Windows, ovvero per far sì che lo stato di tale finestra corrisponda allo stato attivato facendo clic con il mouse sulla relativa barra del titolo.

Application.VBE.Windows(9).SetFocus


Esempio di metodo SetSelection

In questo esempio il metodo SetSelection viene utilizzato per selezionare il testo il cui primo carattere è quello immediatamente successivo al quarto carattere della seconda riga di CodePanes(1) e il cui ultimo carattere è il quindicesimo carattere della terza riga del medesimo riquadro.

Application.VBE.CodePanes(1).SetSelection 2,4,3,15


Esempio di metodo Show

In questo esempio il metodo Show viene utilizzato per spostare in primo piano il riquadro del codice specificato.

Application.VBE.CodePanes(2).Show


Oggetto AddIn

L'oggetto AddIn fornisce informazioni sull'aggiunta di altre aggiunte.

Sintassi

oggetto.AddIn

Osservazioni

Viene creato un oggetto AddIn per ogni aggiunta visualizzata in Gestione aggiunte.


Insieme AddIns

Restituisce un insieme delle aggiunte registrate per VBA.

Sintassi

oggetto.AddIns

Osservazioni

È possibile accedere all'insieme AddIns tramite l'oggetto VBE. Ad ogni aggiunta elencata in Gestione risorse in VBE.è associato un oggetto dell'insieme AddIns.


Oggetto CommandBar

L'oggetto CommandBar contiene altri oggetti CommandBar, che possono fungere sia da pulsanti che da comandi di menu.

Sintassi

CommandBar


Oggetto CodeModule

Rappresenta il codice alla base di un componente, quale un form, una classe o un documento.

Osservazioni

L'oggetto CodeModule consente di modificare tramite inserimenti, eliminazioni e modifiche il codice associato a un componente.

Ciascun componente è associato a un solo oggetto CodeModule, che a sua volta può essere associato a più riquadri del codice.

I metodi associati all'oggetto CodeModule consentono di gestire il testo del codice e di restituire informazioni relative al codice riga per riga. È possibile, ad esempio, utilizzare il metodo AddFromString per aggiungere testo in un modulo. Con questo metodo il testo viene inserito immediatamente prima della routine iniziale del modulo oppure, se non esiste alcuna routine, alla fine del modulo.

Per restituire l'oggetto VBComponent associato a un modulo di codice, è necessario utilizzare la proprietà Parent.


Oggetto CommandBarEvents

Viene restituito dalla proprietà CommandBarEvents e genera un evento quando si fa clic su un controllo della barra di comando.

Osservazioni

L'oggetto CommandBarEvents viene restituito dalla proprietà CommandBarEvents dell'oggetto Events. L'interfaccia dell'oggetto restituito contiene soltanto l'evento Click che è possibile gestire utilizzando la dichiarazione dell'oggetto WithEvents.


Insieme CommandBars

Contiene tutte le barre di comando di un progetto, comprese quelle che supportano i menu di scelta rapida.

Osservazioni

L'insieme CommandBars consente di aggiungere barre di comando e controlli o controlli in barre di comando esistenti predefinite e di attivare le aggiunte (add-in).


Oggetto CodePane

Rappresenta un riquadro del codice.

Osservazioni

L'oggetto CodePane consente di gestire la posizione del testo visibile o della selezione di testo visualizzata nel riquadro del codice.

Per rendere visibile il riquadro del codice specificato, è possibile utilizzare il metodo Show. Per impostare la selezione in un riquadro del codice, utilizzare il metodo SetSelection. Per restituire la posizione della selezione in un riquadro del codice, utilizzare il metodo GetSelection.


Insieme CodePanes

Contiene i riquadri del codice attivi dell'oggetto VBE.

Osservazioni

L'insieme CodePanes consente di accedere ai riquadri del codice aperti di un progetto.

Per restituire il numero di riquadri del codice attivi in un insieme, è possibile utilizzare la proprietà Count.


Oggetto Events

Fornisce proprietà che consentono di collegare le aggiunte (add-in) a tutti gli eventi di Visual Basic, Applications Edition.

Osservazioni

L'oggetto Events fornisce proprietà che restituiscono oggetti di origine dell'evento. Utilizzare queste proprietà per restituire oggetti di origine dell'evento che segnalano le modifiche apportate all'ambiente Visual Basic, Applications Edition.

Le proprietà dell'oggetto Events restituiscono oggetti corrispondenti al nome della proprietà. La proprietà CommandBarEvents, ad esempio, restituisce l'oggetto CommandBarEvents.


Insieme LinkedWindows

Contiene tutte le finestre collegate in una cornice di finestre collegate.

Osservazioni

L'insieme LinkedWindows consente di modificare lo stato di ancoraggio e di collegamento delle finestre nell'ambiente di sviluppo.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.

La proprietà LinkedWindowFrame dell'oggetto Window restituisce un oggetto Window a cui è associato un insieme LinkedWindows valido.

Le cornici di finestre collegate contengono tutte le finestre che è possibile collegare o ancorare, ovvero tutte le finestre ad eccezione della finestre del codice, delle finestre di progettazione, del Visualizzatore oggetti e delle finestre Trova e Sostituisci.

Se tutti i riquadri di una cornice di finestre collegate vengono spostati in un'altra finestra, la cornice di finestre collegate priva di riquadri verrà eliminata. Viene invece conservata se tutti i riquadri vengono rimossi dalla finestra principale.

Per verificare o impostare la visibilità di una finestra, utilizzare la proprietà Visible.

Per aggiungere una finestra nell'insieme delle finestre collegate, è possibile utilizzare il metodo Add. Una finestra che corrisponde a un riquadro in una cornice di finestre collegate può essere inserita in un'altra cornice di finestre collegate. Per rimuovere una finestra dall'insieme delle finestre collegate, utilizzare il metodo Remove. La finestra verrà in tal modo scollegata o disancorata.

L'insieme LinkedWindows viene utilizzato per ancorare e disancorare le finestre dalla cornice di finestre principale.


Oggetto Property

Rappresenta le proprietà di un oggetto visualizzate nella finestra Proprietà di ciascun componente.

Osservazioni

Per restituire o impostare il valore di una proprietà di un componente, utilizzare la proprietà Value dell'oggetto Property.

Per tutti i componenti è disponibile almeno una proprietà Name. Per restituire o impostare il valore di una proprietà, utilizzare la proprietà Value dell'oggetto Property. Tale proprietà restituisce un valore Variant del tipo appropriato. Se il valore restituito è un oggetto, la proprietà Value restituirà l'insieme Properties contenente gli oggetti Property che rappresentano le singole proprietà dell'oggetto. Per accedere ai vari oggetti Property, è possibile utilizzare il metodo Item sull'insieme Properties restituito.

Se il valore restituito dall'oggetto Property è un oggetto, sarà possibile utilizzare la proprietà Object per impostare l'oggetto Property su un nuovo oggetto.


Insieme Properties (modello di oggetti aggiunte VBA)

Rappresenta le proprietà di un oggetto.

Osservazioni

L'insieme Properties consente di accedere alle proprietà visualizzate nella finestra Proprietà. A ciascuna di tali proprietà corrisponde un oggetto nell'insieme Properties.


Oggetto Reference

Rappresenta un riferimento alla libreria dei tipi o a un progetto.

Osservazioni

L'oggetto Reference consente di verificare se un riferimento è ancora valido.

Se un riferimento non punta più a un riferimento valido, la proprietà IsBroken restituirà True. Se si tratta di un riferimento predefinito che non è possibile spostare o rimuovere, la proprietà BuiltIn restituirà True. Per stabilire se il riferimento che si desidera aggiungere o rimuovere è quello corretto, utilizzare la proprietà Name.


Insieme References

Rappresenta il gruppo di riferimenti del progetto.

Osservazioni

L'insieme References consente di aggiungere e rimuovere riferimenti e corrisponde al gruppo di riferimenti selezionati nella finestra di dialogo Riferimenti.


Oggetto ReferencesEvents

Viene restituito dalla proprietà ReferencesEvents.

Osservazioni

L'oggetto ReferencesEvents è l'origine degli eventi che vengono generati quando si aggiunge o si rimuove un riferimento da un progetto. Dopo aver aggiunto un riferimento in un progetto, viene generato l'evento ItemAdded, mentre dopo aver rimosso un riferimento, viene generato l'evento ItemRemoved.


Oggetto VBComponent

Rappresenta un componente, quale un modulo di classe o un modulo standard, incluso in un progetto.

Osservazioni

L'oggetto VBComponent consente di accedere al modulo di codice associato a un componente o di modificare le impostazioni delle proprietà di un componente.

Per identificare il tipo di componente a cui l'oggetto VBComponent fa riferimento, è possibile utilizzare la proprietà Type. Per identificare l'insieme in cui il componente è incluso, utilizzare la proprietà Collection.


Insieme VBComponents

Rappresenta i componenti inclusi in un progetto.

Osservazioni

L'insieme VBComponents consente di accedere, aggiungere o rimuovere i componenti di un progetto. Un componente può essere un form, un modulo o una classe. VBComponents è un insieme standard che è possibile utilizzare in un blocco For...Each.

Per restituire il progetto in cui l'insieme VBComponents è incluso, è possibile utilizzare la proprietà Parent.

In Visual Basic, Applications Edition, è possibile utilizzare il metodo Import per aggiungere in un progetto un componente incluso in un file.


Oggetto VBE

Oggetto di primo livello che contiene tutti gli altri oggetti e insiemi rappresentati in Visual Basic, Applications Edition.

Osservazioni

Per accedere agli oggetti inclusi nell'oggetto VBE, è possibile utilizzare gli insiemi indicati di seguito:

•	Utilizzare l'insieme VBProjects per accedere all'insieme dei progetti.

•	Utilizzare l'insieme AddIns per accedere all'insieme di aggiunte.

•	Utilizzare l'insieme Windows per accedere all'insieme delle finestre.

•	Utilizzare l'insieme CodePanes per accedere all'insieme dei riquadri del codice.

•	Utilizzare l'insieme CommandBars per accedere all'insieme delle barre di comando.

Utilizzare l'oggetto Events per accedere alle proprietà che consentono di connettersi a tutti gli eventi di Visual Basic, Applications Edition tramite le aggiunte. Le proprietà dell'oggetto Events restituiscono oggetti dello stesso tipo del nome della proprietà. Ad esempio, la proprietà CommandBarEvents restituisce l'oggetto CommandBarEvents.

Per restituire il componente attivo, è possibile utilizzare la proprietà SelectedVBComponent. Il componente attivo è quello evidenziato nella finestra Progetto. Se l'elemento selezionato nella finestra Progetto non è un componente, la proprietà SelectedVBComponent restituirà Nothing.

Nota   Per tutti gli oggetti di questo modello ad oggetti è disponibile una proprietà VBE che punta all'oggetto VBE.


Insieme VBNewProjects

Rappresenta tutti i nuovi progetti nell'ambiente di sviluppo.

Osservazioni

L'insieme VBNewProjects consente di accedere a progetti specifici in un'istanza dell'ambiente di sviluppo. È un insieme standard che può essere reiterato utilizzando un blocco For… Each.


Oggetto VBProject

Rappresenta un progetto.

Osservazioni

L'oggetto VBProject consente di impostare proprietà per il progetto e di accedere agli insiemi VBComponents e References.


Insieme VBProjects

Rappresenta tutti i progetti aperti nell'ambiente di sviluppo.

Osservazioni

L'insieme VBProjects consente di accedere a progetti specifici in un'istanza dell'ambiente di sviluppo. È un insieme standard che è possibile utilizzare in un blocco For Each.


Oggetto Window

Rappresenta una finestra dell'ambiente di sviluppo.

Osservazioni

L'oggetto Window consente di visualizzare, nascondere e posizionare finestre.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.

Per chiudere una finestra dell'insieme Windows, è possibile utilizzare il metodo Close. Tale metodo ha un effetto diverso a seconda del tipo di finestra, come indicato nella tabella seguente.

Finestra	Azione del metodo Close
Finestra del codice	Rimuove la finestra dall'insieme Windows.
Finestra di progettazione	Rimuove la finestra dall'insieme Windows.
Oggetti Window di tipo cornice di finestre collegate	Le finestre diventano finestre non collegate distinte.
Nota   Nelle finestre del codice e di progettazione il metodo Close consente di chiudere la finestra. Impostando la proprietà Visible su False, la finestra viene nascosta, ma non chiusa. L'utilizzo del metodo Close in finestre dell'ambiente di sviluppo, quali la finestra Progetto o la finestra Proprietà corrisponde all'impostazione della proprietà Visible su False.

Per spostare lo stato attivo su una finestra, è possibile utilizzare il metodo SetFocus.

Per ripristinare o impostare la visibilità di una finestra, è possibile utilizzare la proprietà Visible.

Per identificare il tipo di finestra in cui si desidera lavorare, è possibile utilizzare la proprietà Type. Se sono disponibili più finestre di un tipo specifico, ad esempio più finestre di progettazione, sarà possibile individuare la finestra in cui si sta lavorando tramite la proprietà Caption. È inoltre possibile individuare la finestra in cui si desidera lavorare tramite la proprietà DesignerWindow dell'oggetto VBComponent o la proprietà Window dell'oggetto CodePane.


Insieme Windows

Contiene tutte le finestre aperte o fisse.

Osservazioni

L'insieme Windows consente di accedere a oggetti Window.

L'insieme Windows include un gruppo fisso di finestre sempre disponibili nell'insieme, quali la finestra Progetto e la finestra Proprietà, nonché un gruppo di finestre corrispondenti a tutte le finestre di progettazione e del codice aperte. Quando si apre una finestra di progettazione o del codice, viene automaticamente aggiunto un nuovo membro nell'insieme Windows. Quando invece una di queste finestre viene chiusa, uno dei membri dell'insieme Windows viene automaticamente rimosso. La chiusura di una finestra fissa dell'ambiente di sviluppo non comporta l'eliminazione dell'oggetto corrispondente dall'insieme, ma un cambiamento dello stato della finestra, che non sarà più visibile.


Esempio di proprietà ActiveCodePane

In questo esempio le proprietà ActiveCodePane e TopLine vengono utilizzate per ottenere il numero della riga superiore nel riquadro del codice attivo.

Debug.Print Application.VBE.ActiveCodePane.TopLine


Esempio di proprietà ActiveVBProject

In questo esempio la proprietà ActiveVBProject viene utilizzata per restituire il nome del progetto attivo.

Debug.Print Application.VBE.ActiveVBProject.Name


Esempio di proprietà ActiveWindow

In questo esempio la proprietà ActiveWindow viene utilizzata per restituire la didascalia della finestra attiva.

Debug.Print Application.VBE.ActiveWindow.Caption


Esempio di proprietà BuiltIn

In questo esempio la proprietà BuiltIn viene utilizzata per restituire un valore Boolean che indica se un determinato riferimento del progetto attivo è o meno predefinito.

Debug.Print Application.VBE.ActiveVBProject.References(1).BuiltIn


Esempio di proprietà Caption

In questo esempio la proprietà Caption viene utilizzata per visualizzare la didascalia della finestra attiva.

Debug.Print Application.VBE.ActiveWindow.Caption


Esempio di proprietà CodeModule

In questo esempio le proprietà CodeModule e CountOfLines vengono utilizzate per restituire il numero delle righe in un modulo di codice specifico.

Debug.Print Application.VBE.ActiveVBProject.VBComponents(6).CodeModule.CountOfLines


Esempio di proprietà CodePane

In questo esempio le proprietà CodePane e TopLine vengono utilizzate per visualizzare il numero della riga superiore nel modulo di codice dell'oggetto VBComponent selezionato.

Debug.Print Application.VBE.SelectedVBComponent.CodeModule.CodePane.TopLine


Esempio di proprietà CodePanes

In questo esempio le proprietà CodePanes e TopLine vengono utilizzate per visualizzare il numero della riga superiore del riquadro del codice specificato.

Debug.Print Application.VBE.CodePanes(3).TopLine


Esempio di proprietà CodePaneView

In questo esempio la proprietà CodePaneView viene utilizzata per restituire un valore che indica se nel riquadro del codice specificato è visualizzata la routine o il modulo intero.

Debug.Print Application.VBE.CodePanes(3).CodePaneView


Esempio di proprietà Collection

In questo esempio le proprietà Collection e Count vengono utilizzate per restituire il numero di oggetti contenuti nel progetto attivo, quando viene visualizzato come un insieme di oggetti.

Debug.Print Application.VBE.ActiveVBProject.Collection.Count


Esempio di proprietà CommandBarEvents

In questo esempio il codice che include la proprietà CommandBarEvents viene utilizzato per supportare qualsiasi codice in grado di gestire un clic del mouse su una barra di comando.

Private WithEvents ce As CommandBarEvents

Sub Test()

    Dim c As CommandBarControl

    Set c = Application.VBE.CommandBars("Strumenti").Controls(1)

    Set ce = Application.VBE.Events.CommandBarEvents(c)

End Sub

Private Sub ce_Click(ByVal CommandBarControl As Object, Handled As Boolean, CancelDefault As Boolean)

    ' Inserire qui il codice di gestione dell'evento

End Sub


Esempio di proprietà Count

In questo esempio la proprietà Count viene utilizzata per restituire il numero di oggetti VBComponent in un progetto specifico.

Debug.Print Application.VBE.VBProjects(1).VBComponents.Count


Esempio di proprietà CountOfDeclarationLines

In questo esempio la proprietà CountOfDeclarationLines viene utilizzata per restituire il numero delle righe di dichiarazione in un riquadro del codice specifico.

Debug.Print Application.VBE.CodePanes(2).CodeModule.CountOfDeclarationLines


Esempio di proprietà CountOfLines

In questo esempio la proprietà CountOfLines viene utilizzata per restituire il numero totale di righe in un riquadro del codice specifico.

Application.VBE.CodePanes(2).CodeModule.CountOfLines


Esempio di proprietà CountOfVisibleLines

In questo esempio la proprietà CountOfVisibleLines viene utilizzata per restituire il numero di righe visibili contemporaneamente in un riquadro del codice specifico, in base all'altezza del riquadro.

Debug.Print Application.VBE.Codepanes(3).CountOfVisibleLines


Esempi della proprietà Description

Nel primo degli esempi seguenti la proprietà Description viene utilizzata per assegnare una descrizione a un progetto specifico. La descrizione viene inoltre stampata allo scopo di verificare che l'assegnazione abbia avuto esito positivo.

Nel secondo esempio la proprietà Description viene utilizzata per restituire nomi descrittivi degli oggetti Reference specificati in un progetto specifico.

Application.VBE.VBProjects(1).Description = "Peperoncino"

Debug.Print Application.VBE.VBProjects(1).Description

Debug.Print Application.VBE.VBProjects(1).References(1).Description

Debug.Print Application.VBE.VBProjects(1).References(2).Description


Esempio di proprietà Designer

In questo esempio le proprietà Designer e Count vengono utilizzate per restituire il numero di controlli in un form. Si noti che la finestra contenente il form deve essere selezionata. L'oggetto Designer rappresenta il form stesso.

Debug.Print Application.VBE.SelectVBComponent.Designer.Controls.Count


Esempio di proprietà FullPath

In questo esempio la proprietà FullPath viene utilizzata per restituire il percorso completo della libreria degli oggetti per il riferimento specificato.

Debug.Print Application.VBE.ActiveVBProject.References(1).FullPath


Esempio di proprietà GUID

In questo esempio la proprietà GUID viene utilizzata per restituire l'identificatore univoco globale per l'oggetto Reference specificato in un determinato progetto.

Debug.Print Application.VBE.VBProjects(1).References(1).GUID


Esempio di proprietà HasOpenDesigner

In questo esempio la proprietà HasOpenDesigner viene utilizzata per determinare se il componente specificato, in questo caso un form, di un determinato progetto ha una finestra di progettazione aperta.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).HasOpenDesigner


Esempio di proprietà Height e Width

In questo esempio le proprietà Height e Width vengono utilizzate per restituire l'altezza e la larghezza della finestra specificata, espressa in twip. Le impostazioni risultano modificate dopo che una finestra viene collegata o ancorata, poiché sono riferite all'oggetto Window al quale la finestra originale viene collegata o ancorata.

Debug.Print Application.VBE.Windows(9).Height

Debug.Print Application.VBE.Windows(9).Width


Esempio di proprietà HelpContextID

In questo esempio la proprietà HelpContextID viene utilizzata per restituire l'ID di contesto del file della Guida corrispondente a un progetto.

Debug.Print Application.VBE.VBProjects(1).HelpContextID


Esempio di proprietà HelpFile

In questo esempio la proprietà HelpFile viene utilizzata per assegnare un file della Guida a un progetto. Viene inoltre verificato che l'assegnazione abbia avuto esito positivo mediante la stampa del percorso del file della Guida.

Application.VBE.VBProjects(1).HelpFile = "C:\Guida\vb5ext.hlp"

Debug.Print Application.VBE.VBProjects(1).HelpFile


Esempio di proprietà IsBroken

In questo esempio la proprietà IsBroken viene utilizzata per restituire un valore che indica se l'oggetto Reference specificato di un determinato progetto è interrotto.

Debug.Print Application.VBE.vbprojects(1).References(1).IsBroken


Esempio di proprietà Left e Top

In questo esempio le proprietà Left e Top vengono utilizzate per restituire le coordinate dell'angolo superiore sinistro di una finestra specifica, espresse in twip. Le impostazioni vengono modificate dopo che una finestra viene collegata o ancorata, poiché fanno riferimento all'oggetto Window al quale la finestra originale è collegata o ancorata.

Debug.Print Application.VBE.Windows(9).Left

Debug.Print Application.VBE.Windows(9).Top


Esempio di proprietà Lines

In questo esempio la proprietà Lines viene utilizzata per restituire un blocco di codice specifico, ovvero dalla riga 1 alla riga 4, in un determinato riquadro del codice.

Debug.Print Application.VBE.CodePanes(1).CodeModule.Lines( 1, 4)


Esempio di proprietà MainWindow

In questo esempio la proprietà MainWindow viene utilizzata per restituire l'oggetto Window che rappresenta la finestra principale e quindi viene stampata la relativa didascalia.

Debug.Print Application.VBE.MainWindow.Caption


Esempio di proprietà Major

In questo esempio la proprietà Major viene utilizzata per restituire il numero della versione principale dell'oggetto Reference specificato in un determinato progetto.

Debug.Print Application.VBE.VBProjects(1).References(1).Major


Esempio di proprietà Minor

In questo esempio la proprietà Minor viene utilizzata per restituire il numero della versione secondaria dell'oggetto Reference specificato in un determinato progetto.

Debug.Print Application.VBE.VBProjects(1).References(1).Minor


Esempio di proprietà Mode

In questo esempio la proprietà Mode viene utilizzata per restituire la modalità del progetto attivo. Il valore restituito è una costante predefinita che rappresenta la modalità del progetto.

Debug.Print Application.VBE.ActiveVBProject.Mode


Esempio di proprietà Name

In questo esempio la proprietà Name viene utilizzata per restituire il nome del membro specificato dell'insieme VBComponents in un progetto specifico.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).Name


Esempio di proprietà NumIndices

In questo esempio la proprietà NumIndices viene utilizzata per restituire il numero di indici appartenenti alla proprietà specificata di un determinato oggetto VBComponent.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).Properties(40).NumIndices


Esempio di proprietà Object

In questo esempio il nome di un'icona viene caricato nell'elenco delle icone per un oggetto specifico, che deve essere un form.

Set Application.VBE.ActiveVBProject.VBComponents(1).Properties("Icon").Object = LoadPicture("Baseball.ico")


Esempio di proprietà Parent

In questo esempio la proprietà Parent viene utilizzata per restituire il nome del contenitore di un oggetto all'interno della gerarchia di oggetti.

Debug.Print Application.VBE.ActiveVBProject.VBComponents.Parent.Name


Esempio di proprietà ProcBodyLine

In questo esempio la proprietà ProcBodyLine viene utilizzata per restituire il numero di riga della prima riga del codice nella routine SetupTabs, all'interno di un riquadro del codice specifico.

Debug.Print Application.VBE.CodePanes(3).CodeModule.ProcBodyLine ("SetupTabs", vbext_pk_Proc)


Esempio di proprietà ProcCountLines

In questo esempio la proprietà ProcCountLines viene utilizzata per restituire il numero di righe di codice nella routine SetupTabs all'interno di un riquadro del codice specifico.

Debug.Print Application.VBE.CodePanes(3).CodeModule.ProcCountLines ("SetupTabs", vbext_pk_Proc)


Esempio di proprietà ProcOfLine

In questo esempio la proprietà ProcOfLine viene utilizzata per restituire il nome della routine che contiene il numero di riga indicato all'interno di un riquadro del codice specifico.

Debug.Print Application.VBE.CodePanes(3).CodeModule.ProcOfLine (1270, vbext_pk_Proc)


Esempio di proprietà ProcStartLine

In questo esempio la proprietà ProcStartLine viene utilizzata per restituire la riga di inizio della routine indicata all'interno di un riquadro del codice specifico.

Debug.Print Application.VBE.CodePanes(3).CodeModule.ProcStartLine ("SetupTabs", vbext_pk_Proc)


Esempio di proprietà Protection

In questo esempio la proprietà Protection viene utilizzata per restituire un valore che indica se un progetto è protetto. Il valore restituito è un numero corrispondente a una costante predefinita che rappresenta lo stato del progetto.

Debug.Print Application.VBE.ActiveVBProject.Protection


Esempio di proprietà ReferencesEvents

In questo esempio il codice che include la proprietà ReferencesEvents viene utilizzato per supportare qualsiasi codice di gestione degli eventi in grado di aggiungere o rimuovere riferimenti.

Private WithEvents X As ReferencesEvents

Sub Test()

    Set X = Application.VBE.Events.ReferencesEvents

End Sub

Private Sub X_ItemAdded(ByVal Reference As VBIDE.Reference)

    ' Inserire qui il codice di supporto per l'aggiunta di elementi

End Sub

Private Sub X_ItemRemoved(ByVal Reference As VBIDE.Reference)

    ' Inserire qui il codice di supporto per la rimozione di elementi

End Sub


Esempio di proprietà Saved

In questo esempio la proprietà Saved viene utilizzata per restituire un valore Boolean che indica se il progetto specificato è stato salvato o meno nello stato corrente.

Debug.Print Application.VBE.VBProjects(1).Saved


Esempio di proprietà SelectedVBComponent

In questo esempio la proprietà SelectedVBComponent viene utilizzata per restituire il componente selezionato.

Debug.Print Application.VBE.SelectedVBComponent.Name


Esempio di proprietà TopLine

In questo esempio la proprietà TopLine viene utilizzata per restituire il numero della riga superiore nel riquadro del codice specificato.

Debug.Print Application.VBE.CodePanes(3).TopLine


Esempio di proprietà Type

In questo esempio la proprietà Type viene utilizzata per restituire un valore che indica il tipo del membro specificato dell'insieme VBComponents in un determinato progetto. Il valore restituito è un numero corrispondente a una costante predefinita per uno dei tipi di componenti.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).Type


Esempio di proprietà Value

In questo esempio la proprietà Value viene utilizzata per restituire il valore della proprietà specificata di un membro dell'insieme VBComponents.

Debug.Print Application.VBE. ActiveVBProject.VBComponents(1).Properties("AcceptLabelsInFormulas").Value


Esempio di proprietà VBE

In questo esempio le proprietà VBE e Name vengono utilizzate per restituire il nome del progetto attivo.

Debug.Print Application.VBE.ActiveVBProject.Name


Esempio di proprietà Version

In questo esempio la proprietà Version viene utilizzata per restituire il numero di versione dell'applicazione host.

Debug.Print Application.VBE.Version


Esempio di proprietà Visible

In questo esempio la proprietà Visible viene utilizzata per restituire un valore Boolean che indica se la finestra specificata è visibile o meno.

Debug.Print Application.VBE.Windows(9).Visible


Esempio di proprietà Window

In questo esempio le proprietà Window e Caption vengono utilizzate per restituire la didascalia del riquadro del codice specificato.

Debug.Print Application.VBE.CodePanes(1).Window.Caption


Esempio di proprietà WindowState

In questo esempio la proprietà WindowState viene utilizzata per restituire lo stato di visualizzazione della finestra specificata. Il valore restituito è un numero corrispondente a una costante predefinita che specifica lo stato di visualizzazione di una finestra.

Debug.Print Application.VBE.Windows(9).WindowState


Proprietà ActiveCodePane

Restituisce l'oggetto CodePane attivo o l'ultimo ad essere stato attivato. Lettura/scrittura.

Osservazioni

È possibile impostare la proprietà ActiveCodePane su qualsiasi oggetto CodePane valido, come illustrato nell'esempio seguente:

Set MyApp.VBE.ActiveCodePane = MyApp.VBE.CodePanes(1)

In questo esempio viene impostato come attivo il primo riquadro del codice in un insieme di riquadri del codice. Per attivare un riquadro del codice, è inoltre possibile utilizzare il metodo Set.


Proprietà ActiveVBProject

Restituisce il progetto attivo della finestra Progetto. Di sola lettura.

Osservazioni

La proprietà ActiveVBProject restituisce il progetto selezionato nella finestra Progetto oppure il progetto in cui sono selezionati i componenti. In quest'ultimo caso, il progetto non è necessariamente selezionato. Indipendentemente dal fatto che il progetto sia o meno selezionato in modo esplicito, è sempre presente un progetto attivo.


Proprietà ActiveWindow

Restituisce la finestra attiva dell'ambiente di sviluppo. Di sola lettura.

Osservazioni

Quando nell'ambiente di sviluppo sono aperte più finestre, l'impostazione della proprietà ActiveWindow corrisponde alla finestra con stato attivo. Se tale finestra è quella principale, ActiveWindow restituisce Nothing.


Proprietà BuiltIn

Restituisce un valore Boolean che indica se il riferimento è o meno un riferimento predefinito che non è possibile rimuovere. Di sola lettura.

Valori restituiti

La proprietà BuiltIn restituisce i seguenti valori:

Valore	Descrizione
True	Il riferimento è un riferimento predefinito che non è possibile rimuovere.
False	Il riferimento non è un riferimento predefinito ed è pertanto possibile rimuoverlo.


Proprietà BuildFileName

Imposta o restituisce il nome della DLL da assegnare al progetto compilato.

Sintassi

oggetto.BuildFileName

Il segnaposto oggetto rappresenta un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".


Proprietà Caption

Restituisce un valore String contenente il titolo della finestra attiva. Di sola lettura.

Osservazioni

Il titolo della attiva finestra è il testo visualizzato nella barra del titolo della finestra.


Proprietà CodeModule

Restituisce un oggetto che rappresenta il codice alla base del componente. Di sola lettura.

Osservazioni

La proprietà CodeModule restituisce Nothing se al componente non è associato alcun modulo di codice.

Nota   L'oggetto CodePane rappresenta una finestra del codice visibile. A un determinato componente possono essere associati più oggetti CodePane. L'oggetto CodeModule rappresenta il codice contenuto in un componente. A un determinato componente può essere associato un solo oggetto CodeModule.


Proprietà CodePane

Restituisce un oggetto CodePane. Di sola lettura.

Osservazioni

Se esiste un riquadro del codice, tale riquadro verrà attivato e la finestra in cui è incluso diventerà la finestra attiva. Se per il modulo non esiste un riquadro del codice, la proprietà CodePane ne creerà uno.


Proprietà CodePanes

Restituisce l'insieme degli oggetti CodePane attivi. Di sola lettura.


Proprietà CodePaneView

Restituisce un valore che indica se nel riquadro del codice è attiva la visualizzazione routine o la visualizzazione modulo intero. Di sola lettura.

Valori restituiti

La proprietà CodePaneView restituisce i seguenti valori:

Costante	Descrizione
vbext_cv_ProcedureView	Nel riquadro del codice specificato è attiva la visualizzazione routine.
vbext_cv_FullModuleView	Nel progetto specificato è attiva la visualizzazione modulo intero.


Proprietà Collection

Restituisce l'insieme contenente l'oggetto che si sta utilizzando. Di sola lettura.

Osservazioni

Per la maggior parte degli oggetti di questo modello ad oggetti è disponibile una proprietà Parent o Collection che si riferisce all'oggetto contenitore.

La proprietà Collection consente di accedere a proprietà, metodi e controlli dell'insieme a cui l'oggetto appartiene.


Proprietà CommandBarEvents

Restituisce l'oggetto CommandBarEvents. Di sola lettura.

Impostazioni

L'impostazione dell'argomento passato alla proprietà CommandBarEvents è la seguente:

Argomento	Descrizione
controllovb	Oggetto del tipo CommandBarControl.
Osservazioni

La proprietà CommandBarEvents consente di restituire un oggetto di origine dell'evento che genera un evento quando si fa clic su un pulsante della barra di comando. L'argomento passato alla proprietà CommandBarEvents è il controllo della barra di comando per il quale viene generato l'evento Click.


Proprietà Connect

Restituisce o imposta lo stato di connessione di un'aggiunta.

Osservazioni

Restituisce True se l'aggiunta è registrata e connessa (attiva).

Restituisce False se l'aggiunta è registrata, ma non connessa (inattiva).


Proprietà Count

Restituisce un valore Long che specifica il numero di elementi di un insieme. Di sola lettura.


Proprietà CountOfLines

Restituisce un valore Long che specifica il numero di righe di codice in un modulo di codice. Di sola lettura.


Proprietà CountOfDeclarationLines

Restituisce un valore Long che specifica il numero di righe di codice nella sezione Dichiarazioni di un modulo di codice. Di sola lettura.


Proprietà CountOfVisibleLines

Restituisce un valore Long che specifica il numero di righe visibili in un riquadro del codice. Di sola lettura.


Proprietà Description

Restituisce o imposta un'espressione stringa contenente il testo descrittivo associato a un oggetto. È di lettura/scrittura per l'oggetto VBProject e di sola lettura per l'oggetto Reference.

Osservazioni

Per l'oggetto VBProject la proprietà Description restituisce o imposta una stringa descrittiva associata al progetto attivo.

Per l'oggetto Reference restituisce invece il nome descrittivo del riferimento.


Proprietà Designer

Restituisce l'oggetto che consente di accedere alle caratteristiche di progettazione di un componente.

Osservazioni

Se all'oggetto è associata una finestra di progettazione aperta, la proprietà Designer restituirà la finestra di progettazione aperta. In caso contrario verrà creata una nuova finestra di progettazione. La finestra di progettazione è una caratteristica di alcuni oggetti VBComponent. Quando, ad esempio, si creano determinati tipi di oggetto VBComponent, insieme all'oggetto viene creata una finestra di progettazione. A un componente può essere associata una sola finestra di progettazione, che sarà sempre la stessa. La proprietà Designer consente di accedere a un oggetto specifico del componente. In alcuni casi, ad esempio in moduli standard e in moduli di classe, non viene creata alcuna finestra di progettazione. Il tipo specifico di oggetto VBComponent, infatti, non supporta tale finestra.

Se all'oggetto VBComponent non è associata una finestra di progettazione, la proprietà Designer restituirà Nothing.


Proprietà DesignerID

Proprietà di sola lettura che restituisce il valore ProgID di una finestra di progettazione ActiveX.


Proprietà FullPath

Restituisce un valore String che specifica il percorso e il nome del file della libreria dei tipi a cui viene fatto riferimento. Di sola lettura.


Proprietà FileName

Restituisce il nome del percorso completo del file  del progetto o del documento host.

Sintassi

oggetto.Filename

Il segnaposto oggetto rappresenta un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".

Osservazioni

Ai progetti non è associato alcun nome oltre al nome del file.

Il nome del percorso restituito è sempre un percorso assoluto, ad esempio "c:\progetti\mioprogetto.vba", anche se è visualizzato come un percorso relativo, ad esempio "..\progetti\mioprogetto.vba").


Proprietà GUID

Restituisce un valore String che specifica l'identificatore della classe di un oggetto. Di sola lettura.


Proprietà HasOpenDesigner

Restituisce un valore Boolean che indica se all'oggetto VBComponent è associata o meno una finestra di progettazione aperta. Di sola lettura.

Valori restituiti

La proprietà HasOpenDesigner restituisce i seguenti valori:

Valore	Descrizione
True	All'oggetto VBComponent è associata una finestra di progettazione aperta.
False	All'oggetto VBComponent non è associata alcuna finestra di progettazione aperta.


Proprietà Height (modello di oggetti aggiunte VBA)

Restituisce o imposta un valore Single che specifica l'altezza della finestra espressa in twip. Lettura/scrittura.

Osservazioni

La modifica dell'impostazione della proprietà Height di una finestra collegata o di una finestra ancorata non ha alcun effetto, a condizione che la finestra rimanga collegata o ancorata.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Proprietà HelpContextID (modello di oggetti aggiunte VBA)

Restituisce o imposta un valore String che specifica l'ID di contesto di un argomento in un file della Guida di Microsoft Windows. Lettura/scrittura.


Proprietà HelpFile (modello di oggetti aggiunte VBA)

Restituisce o imposta un valore String che specifica il file della Guida di Microsoft Windows per un progetto. Lettura/scrittura.


Proprietà IndexedValue (modello di oggetti aggiunte VBA)

Restituisce o imposta un valore per un membro di una proprietà corrispondente a un elenco con indici o a una matrice.

Osservazioni

Il valore restituito e impostato dalla proprietà IndexedValue è un'espressione che restituisce un tipo supportato dall'oggetto. Con le proprietà corrispondenti a un elenco con indici o a una matrice, è necessario utilizzare la proprietà IndexedValue anziché la proprietà Value. Un elenco con indici è un'espressione numerica che specifica la posizione dell'indice.

La proprietà IndexedValue accetta fino a 4 indici. Il numero di indici supportato corrisponde al valore restituito dalla proprietà NumIndices.

La proprietà IndexedValue viene utilizzata solo se il valore della proprietà NumIndices è maggiore di zero. I valori di elenchi con indice vengono impostati o restituiti con un solo indice.


Proprietà IsBroken

Restituisce un valore Boolean che indica se l'oggetto Reference punta o meno a un riferimento valido del registro di configurazione. Di sola lettura.

Valori restituiti

La proprietà IsBroken restituisce i seguenti valori:

Valore	Descrizione
True	L'oggetto Reference non punta più a un riferimento valido del database di registrazione.
False	L'oggetto Reference punta a un riferimento valido del database di registrazione.


Proprietà Left

Restituisce o imposta un valore Single che specifica la posizione del bordo sinistro della finestra sullo schermo espressa in twip. Lettura/scrittura.

Osservazioni

Il valore restituito dalla proprietà Left dipende dal fatto che la finestra sia collegata o ancorata.

Nota   La modifica dell'impostazione della proprietà Left di una finestra collegata o ancorata non ha alcun effetto, a condizione che la finestra rimanga collegata o ancorata.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Proprietà Lines

Restituisce una stringa che indica il numero di righe di codice specificato.

Sintassi

oggetto.Lines(rigainizio, conteggio) As String

La sintassi della proprietà Lines è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
rigainizio	Obbligatoria. Valore Long che specifica il numero della riga da cui iniziare.
conteggio	Obbligatoria. Valore Long che specifica il numero di righe che si desidera venga restituito.
Osservazioni

In un modulo di codice i numeri di riga iniziano da 1.


Proprietà LinkedWindowFrame

Restituisce l'oggetto Window che rappresenta la cornice contenente la finestra. Di sola lettura.

Osservazioni

La proprietà LinkedWindowFrame consente di accedere all'oggetto che rappresenta la cornice di finestre collegate. A tale cornice sono associate proprietà diverse rispetto a quelle della finestra o finestre in essa contenute. Se la finestra non è collegata, la proprietà LinkedWindowFrame restituisce Nothing.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Proprietà LinkedWindows

Restituisce l'insieme di tutte le finestre collegate contenute in una cornice di finestre collegate. Di sola lettura.

Osservazioni

La proprietà LinkedWindows è una proprietà di accesso, ovvero restituisce un oggetto dello stesso tipo del nome della proprietà.


Proprietà MainWindow

Restituisce un oggetto Window che rappresenta la finestra principale dell'ambiente di sviluppo di Visual Basic. Di sola lettura.

Osservazioni

È possibile utilizzare l'oggetto Window restituito dalla proprietà MainWindow per aggiungere o rimuovere finestre ancorate o per ingrandire, ridurre a icona, nascondere o ripristinare la finestra principale dell'ambiente di sviluppo di Visual Basic.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Proprietà Major

Restituisce un valore Long contenente il numero di versione principale della libreria dei tipi a cui viene fatto riferimento. Di sola lettura.

Osservazioni

Il numero restituito dalla proprietà Major corrisponde al numero di versione memorizzato nella libreria dei tipi per la quale è stato impostato il riferimento.


Proprietà Minor

Restituisce un valore Long che indica il numero di versione secondario della libreria dei tipi a cui viene fatto riferimento. Di sola lettura.

Osservazioni

Il numero restituito dalla proprietà Minor corrisponde al numero di versione secondario memorizzato nella libreria dei tipi per la quale è stato impostato il riferimento.


Proprietà Mode

Restituisce un valore che indica la modalità del progetto specificato. Di sola lettura.

Valori restituiti

La proprietà Mode restituisce i seguenti valori:

Costante	Descrizione
vbext_vm_RunMode	Il progetto specificato è in modalità esecuzione.
vbext_vm_BreakMode	Il progetto specificato è in modalità interruzione.
vbext_vm_DesignMode	Il progetto specificato è in modalità progettazione.


Proprietà Name (modello di oggetti aggiunte VBA)

Restituisce o imposta un valore String che specifica il nome utilizzato nel codice per identificare un oggetto. È di lettura/scrittura per gli oggetti VBProject e VBComponent e di sola lettura per gli oggetti Property e Reference.

Osservazioni

Nella tabella seguente è indicata la modalità di applicazione della proprietà Name ai vari oggetti.

Oggetto	Risultato dell'impostazione della proprietà Name
VBProject	Restituisce o imposta il nome del progetto attivo.
VBComponent	Restituisce o imposta il nome del componente. Se si imposta un nome già in uso o non valido, verrà generato un errore.
Property	Restituisce il nome della proprietà esattamente come viene visualizzato nella finestra Proprietà. Corrisponde al valore utilizzato per definire gli indici nell'insieme Properties e non può essere impostato.
Reference	Restituisce il nome del riferimento nel codice. Tale nome non può essere impostato.
Il nome predefinito dei nuovi oggetti è composto dal tipo dell'oggetto e da un numero intero univoco. Il nome del primo nuovo oggetto Form, ad esempio, è Form1, il nome di un nuovo oggetto Form è Form1 e quello del terzo controllo TextBox inserito in un form è TextBox3.

L'impostazione della proprietà Name di un oggetto deve iniziare con una lettera e può essere composta da un massimo di 40 caratteri. Può inoltre includere numeri e caratteri di sottolineatura (_), ma non segni di punteggiatura e spazi. A form e moduli non è possibile assegnare lo stesso nome di un altro oggetto pubblico quale Clipboard, Screen o App. L'impostazione della proprietà Name può essere una parola chiave, un nome di proprietà o il nome di un altro oggetto. Questo tipo di impostazione può tuttavia creare conflitti nel codice.


Proprietà NumIndices (modello di oggetti aggiunte VBA)

Restituisce il numero di indici della proprietà restituito dall'oggetto Property.

Osservazioni

Il valore della proprietà NumIndices può essere un intero compreso tra 0 e 4. Per la maggior parte delle proprietà, NumIndices restituisce 0. Le proprietà con indici convenzionali restituiscono 1, mentre le matrici di proprietà possono restituire 2.


Proprietà Object

Restituisce o imposta il valore di un oggetto restituito da una proprietà. Lettura/scrittura.

Osservazioni

Se una proprietà restituisce un oggetto, per restituire o impostare il valore di tale oggetto, è necessario utilizzare la proprietà Object.


Proprietà Parent

Restituisce l'oggetto o l'insieme che contiene un altro oggetto o insieme. Di sola lettura.

Osservazioni

Per la maggior parte degli oggetti è disponibile una proprietà Parent o Collection che fa riferimento all'oggetto contenitore in questo modello ad oggetti. La proprietà Collection viene utilizzata se l'oggetto contenitore è un insieme.

La proprietà Parent consente di accedere a proprietà, metodi e controlli dell'oggetto contenitore di un oggetto.


Proprietà ProcBodyLine

Restituisce la prima riga di una routine.

Sintassi

oggetto.ProcBodyLine(nomeroutine, tiporoutine) As Long

La sintassi di ProcBodyLine è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomeroutine	Obbligatoria. Valore String contenente il nome della routine.
tiporoutine	Obbligatoria. Specifica il tipo di routine da trovare. Poiché le routine Property possono essere rappresentate in più modi nel modulo, è necessario specificare il tipo di routine che si desidera trovare. Per tutte le routine diverse dalle routine Property (ovvero le routine Sub e Function) viene utilizzata la costante vbext_pk_Proc.
Per l'argomento tiporoutine è possibile utilizzare le seguenti costanti:

Costante	Descrizione
vbext_pk_Get	Specifica una routine che restituisce il valore di una proprietà.
vbext_pk_Let	Specifica una routine che assegna un valore a una proprietà.
vbext_pk_Set	Specifica una routine che imposta un riferimento a un oggetto.
vbext_pk_Proc	Specifica tutte le routine diverse dalle routine Property.
Osservazioni

La prima riga di una routine è la riga in cui appare l'istruzione Sub, Function o Property.


Proprietà ProcCountLines

Restituisce il numero di righe della routine specificata.

Sintassi

oggetto.ProcCountLines(nomeroutine, tiporoutine) As Long

La sintassi di ProcCountLines è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomeroutine	Obbligatoria. Valore String contenente il nome della routine.
tiporoutine	Obbligatoria. Specifica il tipo di routine da trovare. Poiché le routine Property possono essere rappresentate in più modi nel modulo, è necessario specificare il tipo di routine che si desidera trovare. Per tutte le routine diverse dalle routine Property (ovvero le routine Sub e Function) viene utilizzata la costante vbext_pk_Proc..
Per l'argomento tiporoutine è possibile utilizzare le seguenti costanti:

Costante	Descrizione
vbext_pk_Get	Specifica una routine che restituisce il valore di una proprietà.
vbext_pk_Let	Specifica una routine che assegna un valore a una proprietà.
vbext_pk_Set	Specifica una routine che imposta un riferimento a un oggetto.
vbext_pk_Proc	Specifica tutte le routine diverse dalle routine Property.
Osservazioni

La proprietà ProcCountLines restituisce il conteggio di tutte le righe vuote o di commento che precedono la dichiarazione di routine e, se la routine è l'ultima routine in un modulo di codice, anche tutte le righe vuote che seguono la routine.


Proprietà ProcOfLine

Restituisce il nome della routine in cui si trova la riga specificata.

Sintassi

oggetto.ProcOfLine(riga, tiporoutine) As String

La sintassi di ProcOfLine è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
riga	Obbligatoria. Valore Long che specifica la riga da controllare.
tiporoutine	Obbligatoria. Specifica il tipo di routine da trovare. Poiché le routine Property possono essere rappresentate in più modi nel modulo, è necessario specificare il tipo di routine che si desidera trovare. Per tutte le routine diverse dalle routine Property (ovvero le routine Sub e Function) viene utilizzata la costante vbext_pk_Proc..
Per l'argomento tiporoutine è possibile utilizzare le seguenti costanti:

Costante	Descrizione
vbext_pk_Get	Specifica una routine che restituisce il valore di una proprietà.
vbext_pk_Let	Specifica una routine che assegna un valore a una proprietà.
vbext_pk_Set	Specifica una routine che imposta un riferimento a un oggetto.
vbext_pk_Proc	Specifica tutte le routine diverse dalle routine Property.
Osservazioni

Una riga viene considerata all'interno di una routine se è una riga vuota o di commento che precede la dichiarazione della routine. Se la routine è l'ultima routine in un modulo di codice, verranno considerate la riga o le righe vuote che seguono la routine.


Proprietà ProcStartLine

Restituisce la riga in cui inizia la routine specificata.

Sintassi

oggetto.ProcStartLine(nomeroutine, tiporoutine) As Long

La sintassi di ProcStartLine è composta dalle seguenti parti:

Parte	Descrizione
oggetto	Obbligatoria. Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
nomeroutine	Obbligatoria. Valore String contenente il nome della routine.
tiporoutine	Obbligatoria. Specifica il tipo di routine da trovare. Poiché le routine Property possono essere rappresentate in più modi nel modulo, è necessario specificare il tipo di routine che si desidera trovare. Per tutte le routine diverse dalle routine Property (ovvero le routine Sub e Function) viene utilizzata la costante vbext_pk_Proc..
Per l'argomento tiporoutine è possibile utilizzare le seguenti costanti:

Costante	Descrizione
vbext_pk_Get	Specifica una routine che restituisce il valore di una proprietà.
vbext_pk_Let	Specifica una routine che assegna un valore a una proprietà.
vbext_pk_Set	Specifica una routine che imposta un riferimento a un oggetto.
vbext_pk_Proc	Specifica tutte le routine diverse dalle routine Property.
Osservazioni

Una routine inizia nella prima riga successiva all'istruzione End Sub della routine precedente. Se è la prima routine, inizia alla fine della sezione Dichiarazioni generale.


Proprietà Protection

Restituisce un valore che indica lo stato di protezione di un progetto. Di sola lettura.

Valori restituiti

La proprietà Protection restituisce i seguenti valori:

Costante	Descrizione
vbext_pp_locked	Il progetto specificato è bloccato.
vbext_pp_none	Il progetto specificato non è protetto.


Proprietà Properties

Restituisce le proprietà di un oggetto. Di sola lettura.

Osservazioni

La proprietà Properties è una proprietà di accesso, ovvero una proprietà che restituisce un oggetto dello stesso tipo del nome della proprietà.


Proprietà References

Restituisce l'insieme di riferimenti nel progetto. Di sola lettura.

Osservazioni

La proprietà References è una proprietà di accesso, ovvero una proprietà che restituisce un oggetto dello stesso tipo del nome della proprietà.


Proprietà ReferencesEvents

Restituisce l'oggetto ReferencesEvents. Di sola lettura.

Impostazioni

L'impostazione dell'argomento passato alla proprietà ReferencesEvents è la seguente:

Argomento	Descrizione
progettovb	Se progettovb punta a Nothing, l'oggetto restituito fornirà eventi per l'insieme References di tutti gli oggetti VBProject dell'insieme VBProjects. Se progettovb punta a un oggetto VBProject valido, l'oggetto restituito fornirà eventi per l'insieme References di quel progetto specifico.
Osservazioni

La proprietà ReferencesEvents richiede un solo argomento e restituisce l'oggetto di origine dell'evento. L'oggetto ReferencesEvents è l'origine degli eventi generati quando si aggiungono o rimuovono riferimenti.


Proprietà Saved

Restituisce un valore Boolean che indica se l'oggetto è stato o meno modificato dopo l'ultimo salvataggio. Lettura/scrittura.

Valori restituiti

La proprietà Saved restituisce i seguenti valori:

Valore	Descrizione
True	L'oggetto non è stato modificato dopo l'ultimo salvataggio.
False	L'oggetto è stato modificato dopo l'ultimo salvataggio.
Osservazioni

Il metodo SaveAs imposta la proprietà Saved su True.

Nota   Se si imposta la proprietà Saved su False nel codice, verrà restituito False e l'oggetto risulterà contrassegnato come se fosse stato modificato dopo l'ultimo salvataggio.


Proprietà SelectedVBComponent

Restituisce il componente selezionato. Di sola lettura.

Osservazioni

La proprietà SelectedVBComponent restituisce il componente selezionato nella finestra Progetto. Se l'elemento selezionato nella finestra Progetto non è un componente, la proprietà SelectedVBComponent restituisce Nothing.


Proprietà Top

Restituisce o imposta un valore Single che specifica la posizione del bordo superiore della finestra sullo schermo espressa in twip. Lettura/scrittura.

Osservazioni

Il valore restituito dalla proprietà Top varia a seconda che la finestra sia o meno ancorata, collegata oppure che sia attiva la visualizzazione ancorata.

Nota   La modifica dell'impostazione della proprietà Top di una finestra collegata o ancorata non ha alcun effetto, a condizione che la finestra rimanga collegata o ancorata.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Proprietà TopLine

Restituisce un valore Long che specifica il numero della prima riga nel riquadro del codice o imposta la riga visualizzata all'inizio del riquadro del codice. Lettura/scrittura.

Osservazioni

La proprietà TopLine consente di restituire o impostare la riga visualizzata all'inizio del riquadro del codice. Se, ad esempio, si desidera che la riga numero 25 sia la prima di un riquadro del codice, è necessario impostare la proprietà TopLine su 25.

L'impostazione della proprietà TopLine deve essere un numero positivo. Se si specifica un valore maggiore del numero effettivo di righe nel riquadro del codice, verrà impostato il numero corrispondente all'ultima riga del riquadro del codice.


Proprietà Type (modello di oggetti aggiunte VBA)

Restituisce un valore numerico o stringa che specifica il tipo di oggetto. Di sola lettura.

Impostazioni

Le possibili impostazioni della proprietà Type per l'oggetto Window sono:

Costante	Valore	Descrizione
vbext_wt_CodeWindow	0	Finestra del codice
vbext_wt_Designer	1	Finestra di progettazione
vbext_wt_Browser	2	Visualizzatore oggetti
vbext_wt_Immediate	5	Finestra Immediata
vbext_wt_ProjectWindow	6	Finestra Progetto
vbext_wt_PropertyWindow	7	Finestra Proprietà
vbext_wt_Find	8	Finestra di dialogo Trova
vbext_wt_FindReplace	9	Finestra di dialogo di ricerca e sostituzione
vbext_wt_LinkedWindowFrame	11	Cornice di finestre collegate
vbext_wt_MainWindow	12	Finestra principale
vbext_wt_Watch	3	Finestra Espressioni di controllo
vbext_wt_Locals	4	Finestra Variabili locali
vbext_wt_Toolbox	10	Casella degli strumenti
vbext_wt_ToolWindow	15	Finestra degli strumenti
 Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.

Le possibili impostazioni della proprietà Type per l'oggetto VBComponent sono:

Costante	Valore	Descrizione
vbext_ct_StdModule	1	Modulo standard
vbext_ct_ClassModule	2	Modulo di classe
vbext_ct_MSForm	3	Microsoft Form
vbext_ct_ActiveXDesigner	11	Finestra di progettazione ActiveX
vbext_ct_Document	100	Modulo di documento
Le possibili impostazioni della proprietà Type per l'oggetto Reference sono:

Costante	Valore	Descrizione
vbext_rk_TypeLib	0	Libreria dei tipi
vbext_rk_Project	1	Progetto
Le possibili impostazioni della proprietà Type per l'oggetto VBProject sono:

Costante	Valore	Descrizione
vbext_pt_HostProject	100	Progetto host
vbext_pt_StandAlone	101	Progetto autonomo


Proprietà Value

Restituisce o imposta un valore Variant che specifica il valore della proprietà. Lettura/scrittura.

Osservazioni

Dato che la proprietà Value restituisce un valore Variant, è possibile accedere a qualsiasi proprietà. Per accedere a un elenco, utilizzare la proprietà IndexedValue.

Se la proprietà rappresentata dall'oggetto Property è di lettura/scrittura, anche la proprietà Value sarà di lettura/scrittura. Se la proprietà è di sola lettura, quando si cerca di impostare la proprietà Value, verrà generato un errore. Se la proprietà è di sola scrittura, verrà generato un errore quando si cerca di restituire la proprietà Value.

La proprietà Value è la proprietà predefinita dell'oggetto Property.


Proprietà VBComponents

Restituisce un insieme dei componenti inclusi in un progetto.

Osservazioni

L'insieme VBComponents consente di accedere ai componenti di un progetto oppure di aggiungerli o rimuoverli. Un componente può essere un form, un modulo o una classe. VBComponents è un insieme standard che è possibile utilizzare in un blocco For… Each.

Per restituire il progetto in cui è incluso l'insieme VBComponents, è possibile utilizzare la proprietà Parent.

In Visual Basic, Applications Edition, è possibile utilizzare il metodo Import per aggiungere in un progetto un componente incluso in un file.


Proprietà VBE

Restituisce l'elemento di primo livello dell'oggetto VBE. Di sola lettura.

Osservazioni

Per tutti gli oggetti è disponibile una proprietà VBE che punta all'elemento di primo livello dell'oggetto VBE.


Proprietà Version

Restituisce un valore String che indica la versione di Visual Basic, Applications Edition utilizzata dall'applicazione. Di sola lettura.

Osservazioni

Il valore della proprietà Version è una stringa che inizia con una o due cifre seguite da un punto e da due cifre; il resto della stringa non è definito e può includere testo o numeri.


Proprietà Visible

Per l'oggetto Window, restituisce o imposta un valore Boolean che specifica la visibilità di una finestra. Lettura/scrittura. Per l'oggetto CodePane, restituisce un valore Boolean che indica se il riquadro del codice è o meno visibile nella finestra. Di sola lettura.

Valori restituiti

La proprietà Visible restituisce i seguenti valori:

Valore	Descrizione
True	(Predefinito) L'oggetto è visibile.
False	L'oggetto è nascosto.


Proprietà Width

Restituisce o imposta un valore Single che specifica la larghezza della finestra espressa in twip. Lettura/scrittura.

Osservazioni

La modifica dell'impostazione della proprietà Width di una finestra collegata o di una finestra ancorata non ha alcun effetto, a condizione che la finestra rimanga collegata o ancorata.

Importante   Gli oggetti, le proprietà e i metodi per la gestione delle finestre collegate, delle cornici di finestre collegate e delle finestre ancorate sono disponibili in Macintosh per motivi di compatibilità con il codice scritto in Windows. Questi elementi del linguaggio generano tuttavia errori di run-time se vengono eseguiti in ambiente Macintosh.


Proprietà Window

Restituisce la finestra in cui è visualizzato il riquadro del codice. Di sola lettura.


Proprietà WindowState

Restituisce o imposta un valore numerico che specifica lo stato visivo della finestra. Lettura/scrittura.

Impostazioni

La proprietà WindowState restituisce o imposta i seguenti valori:

Costante	Valore	Descrizione
vbext_ws_Normal	0	(Predefinito) Normale
vbext_ws_Minimize	1	Ridotto a icona
vbext_ws_Maximize	2	Ingrandito alle dimensioni massime


Proprietà CommandBars

Contiene tutte le barre di comando di un progetto, incluse quelle che supportano i menu di scelta rapida.


Proprietà AddIns

Restituisce un insieme che viene utilizzato dalle aggiunte (add-in) per registrare i relativi componenti di automazione nel modello di oggetti di tipo extensibility.

Sintassi

oggetto.AddIns

Il segnaposto oggetto rappresenta un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".


Proprietà Events

Fornisce le proprietà che consentono alle aggiunte (add-in) di collegarsi a tutti gli eventi in Visual Basic, Applications Edition.

Sintassi

oggetto.Events

Il segnaposto oggetto rappresenta un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".


Proprietà VBProjects

Restituisce l'insieme VBProjects, che rappresenta tutti i progetti correnti aperti nell'IDE di Visual Basic.

Sintassi

oggetto.VBProjects

Il segnaposto oggetto rappresenta un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".


Proprietà Windows

Restituisce l'oggetto Window, che rappresenta una finestra nell'IDE di Visual Basic.

Sintassi

oggetto.Window

Il segnaposto oggetto rappresenta un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".


Proprietà ProgID

Restituisce l'ID programmatico (ProgID) del controllo rappresentato dall'oggetto VBControl.

Sintassi

oggetto.ProgID

Il segnaposto oggetto rappresenta un'espressione oggetto che definisce un oggetto dell'elenco "Si applica a".