Procedura: Aggiungere un gestore eventi
Le procedure per aggiungere gestori eventi a un modello di modulo con codice gestito di Microsoft Office InfoPath 2007 tramite Microsoft Visual Studio Tools for Applications (VSTA) sono simili a quelle utilizzate per l'aggiunta di gestori eventi per script. Per aggiungere, ad esempio, un gestore eventi per l'evento Loading, aprire il modello di modulo in modalità progettazione di InfoPath, scegliere Programmazione dal menu Strumenti e quindi Evento Loading. Lo stato attivo passerà automaticamente alla bozza di gestore eventi nell'editor del codice di VSTA.
Le stesse procedure vengono utilizzate da Visual Studio 2005 con Microsoft Visual Studio Tools per Microsoft Office System 2007 o da Visual Studio 2008 con Visual Studio Tools per Office, ad eccezione dell'aggiunta di gestori eventi per eventi a livello di modulo, ovvero gli eventi Loading, ViewSwitched, ContextChanged e Sign. Tali differenze vengono descritte nelle procedure seguenti.
.gif) Importante: |
|---|
L'aggiunta di un gestore eventi genera codice di associazione degli eventi nel metodo InternalStartup del file FormCode.cs o FormCode.vb nel progetto modello di modulo. Evitare di creare il metodo InternalStartup o di aggiungere codice aggiuntivo interno al metodo manualmente. |
Aggiungere un gestore eventi per l'evento Click di un controllo Pulsante
Se si utilizza InfoPath, aprire il modello di modulo in modalità progettazione.
Se si utilizza Visual Studio, aprire un progetto Modello di modulo InfoPath.
Nel riquadro attività Controlli o nella Casella degli strumenti di Visual Studio trascinare un controllo Pulsante nel modulo.
Fare doppio clic sul pulsante e quindi fare clic su Modifica codice modulo.
Lo stato attivo passerà alla bozza di gestore eventi per l'evento Clicked nell'editor del codice di VSTA o di Visual Studio.
Aggiungere un gestore eventi per l'evento Changing, Validating o Changed di un campo o gruppo
Se si utilizza InfoPath, aprire il modello di modulo in modalità progettazione.
Se si utilizza Visual Studio, aprire un progetto Modello di modulo InfoPath.
Fare clic con il pulsante destro del mouse su un controllo per l'immissione di dati associato al campo o al gruppo, ad esempio un controllo Casella di testo.
Scegliere Programmazione e quindi fare clic sull'evento per cui si desidera creare un gestore eventi. Lo stato attivo passerà alla bozza di gestore eventi per l'evento Changing, Validating o Changed nell'editor del codice di VSTA o di Visual Studio.
Nota:Se è stata selezionata la casella di controllo Attiva solo caratteristiche compatibili con browser nella finestra di dialogo Progetta modulo durante la creazione del modello di modulo oppure è stata selezionata la casella di controllo Progetta modello di modulo da aprire in un browser o in InfoPath nella categoria Compatibilità della finestra di dialogo Opzioni modulo, il comando per l'evento Changing non sarà disponibile. Ciò è dovuto al fatto che i gestori eventi per l'evento Changing non sono supportati nelle regole business dei modelli di modulo pubblicati in raccolte documenti in Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.
Aggiungere un gestore eventi per gli eventi Loading, ViewSwitched, ContextChanged e Sign di un modulo
Se si utilizza InfoPath, aprire il modello di modulo in modalità progettazione.
Se si utilizza Visual Studio, aprire un progetto Modello di modulo InfoPath.
In InfoPath scegliere Programmazione dal menu Strumenti e quindi fare clic sull'evento del modulo per cui si desidera scrivere un gestore eventi.
In Visual Studio scegliere Evento dal menu Inserisci e quindi aggiungere l'evento del modulo per cui si desidera scrivere un gestore eventi.
Lo stato attivo passerà alla bozza di gestore eventi per l'evento Loading, ViewSwitched, ContextChanged o Sign nell'editor del codice di VSTA o di Visual Studio.
Nota:Se è stata selezionata la casella di controllo Attiva solo caratteristiche compatibili con browser nella finestra di dialogo Progetta modulo durante la creazione del modello di modulo oppure è stata selezionata la casella di controllo Progetta modello di modulo da aprire in un browser o in InfoPath nella categoria Compatibilità della finestra di dialogo Opzioni moduli, il comando per l'evento ContextChanged o Sign non sarà disponibile. Ciò è dovuto al fatto che i gestori eventi per gli eventi ContextChanged e Sign non sono supportati dalle regole business dei modelli di moduli pubblicati in raccolte documenti in Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.
Aggiungere un gestore eventi per l'evento Submit di un modulo
Se si utilizza InfoPath, aprire il modello di modulo in modalità progettazione.
Se si utilizza Visual Studio, aprire un progetto Modello di modulo InfoPath e quindi fare clic sulla scheda manifest.xsf [Progettazione] per visualizzare il file di progettazione del modulo.
Scegliere Opzioni invio modulo dal menu Strumenti.
Fare clic su Consenti agli utenti di inviare il modulo, su Esegui azione personalizzata tramite codice e quindi su Modifica codice.
Lo stato attivo passerà alla bozza di gestore eventi per l'evento Submit nell'editor del codice di VSTA o di Visual Studio.
Aggiungere un gestore eventi per l'evento Save di un modulo
Se si utilizza InfoPath, aprire il modello di modulo in modalità progettazione.
Se si utilizza Visual Studio, aprire un progetto Modello di modulo InfoPath e quindi fare clic sulla scheda manifest.xsf [Progettazione] per visualizzare il file di progettazione del modulo.
Scegliere Opzioni modulo dal menu Strumenti.
Fare clic sulla categoria Apertura e salvataggio, selezionare la casella di controllo Salva con codice personalizzato e quindi fare clic su Modifica.
Lo stato attivo passerà alla bozza di gestore eventi per l'evento Save nell'editor del codice di VSTA o di Visual Studio.
Nota:Se è stata selezionata la casella di controllo Attiva solo caratteristiche compatibili con browser nella finestra di dialogo Progetta modulo durante la creazione del modello di modulo oppure è stata selezionata la casella di controllo Progetta modello di modulo da aprire in un browser o in InfoPath nella categoria Compatibilità della finestra di dialogo Opzioni modulo, la casella di controllo Salva con codice personalizzato non sarà disponibile. Ciò è dovuto al fatto che i gestori eventi per l'evento Save non sono supportati nelle regole business dei modelli di modulo pubblicati in raccolte documenti in Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.
Aggiungere un gestore eventi per l'evento VersionUpgrade di un modulo
Se si utilizza InfoPath, aprire il modello di modulo in modalità progettazione.
Se si utilizza Visual Studio, aprire un progetto Modello di modulo InfoPath e quindi fare clic sulla scheda manifest.xsf [Progettazione] per visualizzare il file di progettazione del modulo.
Scegliere Opzioni modulo dal menu Strumenti.
Fare clic sulla categoria Programmazione, selezionare Utilizza evento personalizzato nell'elenco a discesa All'aggiornamento della versione e quindi fare clic su Modifica.
Lo stato attivo passerà alla bozza di gestore eventi per l'evento Save nell'editor del codice di VSTA o di Visual Studio.
Aggiungere un gestore eventi per l'evento Merge di un modulo
Se si utilizza InfoPath, aprire il modello di modulo in modalità progettazione.
Se si utilizza Visual Studio, aprire un progetto Modello di modulo InfoPath e quindi fare clic sulla scheda manifest.xsf [Progettazione] per visualizzare il file di progettazione del modulo.
Scegliere Opzioni modulo dal menu Strumenti.
Fare clic sulla categoria Avanzate selezionare la casella di controllo Consenti unione moduli e quindi fare clic su Modifica.
Lo stato attivo passerà alla bozza di gestore eventi per l'evento Merge nell'editor del codice di VSTA o di Visual Studio.
Nota:Se è stata selezionata la casella di controllo Attiva solo caratteristiche compatibili con browser nella finestra di dialogo Progetta modulo durante la creazione del modello di modulo oppure è stata selezionata la casella di controllo Progetta modello di modulo da aprire in un browser o in InfoPath nella categoria Compatibilità della finestra di dialogo Opzioni modulo, la casella di controllo Consenti unione moduli non sarà disponibile. Ciò è dovuto al fatto che i gestori eventi per l'evento Merge non sono supportati nelle regole business dei modelli di modulo pubblicati in raccolte documenti in Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.