Condividi tramite


Cenni preliminari sui controlli Windows Form nei documenti di Office

Aggiornamento: Luglio 2008

Si applica a

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Progetti a livello di documento

  • Excel 2003

  • Excel 2007

  • Word 2003

  • Word 2007

Progetti a livello di applicazione

  • Excel 2007

  • Word 2007

Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.

I controlli Windows Form sono oggetti con cui gli utenti possono interagire per immettere o modificare dati. Nei progetti a livello di documento per Microsoft Office Excel e Microsoft Office Word, è possibile aggiungere controlli Windows Form in fase di progettazione al documento o alla cartella di lavoro del progetto oppure aggiungerli in fase di esecuzione a livello di codice. A partire da Visual Studio 2008 Service Pack 1 (SP1), tali controlli possono essere aggiunti a livello di codice a qualsiasi documento o foglio di lavoro aperto in fase di esecuzione in un componente aggiuntivo a livello di applicazione per Excel 2007 o Word 2007.

Per ulteriori informazioni, vedere la classe Procedura: aggiungere controlli Windows Form a documenti di Office.

Utilizzo di controlli Windows Form

È possibile aggiungere controlli Windows Form a documenti e a elementi dell'interfaccia utente personalizzabili, inclusi riquadri azioni, riquadri attività personalizzati e Windows Form. I controlli Windows Form presentano in genere lo stesso comportamento nei documenti e negli altri elementi dell'interfaccia utente. Esistono tuttavia alcune differenze. Per informazioni, vedere Limitazioni dei controlli Windows Form nei documenti di Office.

La decisione di aggiungere controlli Windows Form a un documento o a un altro elemento dell'interfaccia utente dipende da vari fattori. Nella progettazione dell'interfaccia utente della soluzione in uso, è necessario prendere in considerazione gli utilizzi dei controlli Windows Form descritti nella tabella seguente.

  • In un documento.

    • Quando si desidera visualizzare costantemente i controlli.

    • Quando si desidera che gli utenti immettano direttamente i dati nel documento, ad esempio nei documenti basati su form in cui l'area di modifica è bloccata.

    • Quando si desidera che i controlli siano visualizzati in linea con i dati nel documento. Se ad esempio si aggiungono pulsanti a ogni riga di un oggetto List, può essere necessario allinearli a ciascun elemento dell'elenco.

  • In un riquadro azioni o un riquadro attività personalizzato.

    • Quando si desidera fornire informazioni contestuali per l'utente.

    • Quando si desidera solo visualizzare i risultati nel documento, e non i controlli e i dati di query.

    • Quando si desidera essere certi che i controlli non vengano stampati con il documento.

    • Quando si desidera impedire che i controlli interferiscano con la visualizzazione del documento.

  • In un Windows Form.

    • Quando si desidera controllare le dimensioni dell'interfaccia utente.

    • Quando si desidera impedire agli utenti di nascondere o eliminare i controlli.

    • Quando si desidera ottenere input dall'utente impedendogli di effettuare operazioni nel documento fino a quando tale input non viene ricevuto.

Aggiunta di controlli Windows Form a livello di codice

È possibile aggiungere controlli Windows Form a documenti di Word e a fogli di lavoro di Excel in fase di esecuzione. In Visual Studio Tools per Office vengono forniti metodi di supporto per l'aggiunta dei controlli Windows Form più comuni. Questi metodi consentono di aggiungere rapidamente controlli al documento di Office e accedere alla funzionalità combinata dei controlli Windows Form e alla funzionalità correlata a Office di questi controlli.

Per ulteriori informazioni, vedere la classe Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Utilizzo di controlli Windows Form in progetti a livello di documento

Alcuni aspetti dell'utilizzo di controlli Windows Form nei documenti sono esclusivi dei progetti a livello di documento, che consentono di progettare l'interfaccia utente del documento tramite la finestra di progettazione di Visual Studio.

Creazione di controlli utente personalizzati

È possibile aggiungere un controllo utente al progetto e poi alla casella degli strumenti. Il controllo utente può essere trascinato direttamente sul documento nello stesso modo in cui si aggiunge un controllo Windows Form al documento. Quando si creano controlli utente, è necessario tenere presenti alcune considerazioni:

  • Non creare un controllo utente sealed. In Visual Studio Tools per Office viene generata una classe wrapper derivata dal controllo utente per estenderlo e supportarne l'utilizzo nel documento; Visual Studio Tools per Office non può derivare da una classe sealed.

  • I controlli utente devono avere l'attributo ComVisibleAttribute impostato su true. Per impostazione predefinita, questo attributo è impostato su true per i controlli utente creati all'interno di un progetto Visual Studio Tools per Office, ma è possibile che tale attributo non sia impostato su true per i controlli utente che fanno parte di progetti esterni.

  • Dopo aver aggiunto un controllo utente al documento, non rinominare o eliminare la classe UserControl dal progetto. Se è necessario rinominare un controllo utente, è necessario dapprima eliminarlo dal documento e poi aggiungerlo di nuovo dopo averne modificato il nome.

Disposizione dei controlli in fase di progettazione

Se si aggiungono più controlli ai documenti di Word e di Excel in fase di progettazione, è possibile impostare rapidamente l'allineamento di tutti i controlli selezionati utilizzando le barre degli strumenti di Microsoft Office Word e di Microsoft Office Excel in Visual Studio. Queste barre degli strumenti sono disponibili solo quando un documento o un foglio di lavoro è aperto nella finestra di progettazione.

Quando si selezionano più controlli nella finestra di progettazione, per disporli è possibile utilizzare i pulsanti presenti nelle barre degli strumenti indicati di seguito:

  • Allinea a sinistra

  • Allinea all'asse verticale

  • Allinea a destra

  • Allinea in alto

  • Allinea all'asse orizzontale

  • Allinea in basso

  • Rendi uguale spaziatura orizzontale

  • Rendi uguale spaziatura verticale

Nota:

Nei progetti Word, questi pulsanti vengono attivati solo se i controlli selezionati non sono in linea con il testo. Per impostazione predefinita, i controlli aggiunti in fase di progettazione al documento sono in linea con il testo. Per ulteriori informazioni, vedere la classe Utilizzo di controlli Windows Form nei documenti di Word.

Eliminazione dei dati obsoleti dalla visualizzazione nelle cartelle di lavoro di Excel durante il caricamento

Quando i controlli Windows Form vengono aggiunti in fase di progettazione ai documenti o ai fogli di lavoro, vengono conservati nel documento quando quest'ultimo viene chiuso. I controlli aggiunti in fase di progettazione vengono definiti anche controlli statici.

Quando si apre una cartella di lavoro di Excel contenente controlli statici, viene visualizzata una bitmap del controllo in un controllo ActiveX, fino a quando non si esegue il codice di personalizzazione e il controllo effettivo viene caricato. La bitmap viene creata e memorizzata nella cartella di lavoro ogni volta che quest'ultima viene salvata. Nella bitmap viene visualizzato il controllo come appariva all'ultimo salvataggio della cartella di lavoro, con gli eventuali dati che erano visualizzati in quel momento. Per ulteriori informazioni sul controllo ActiveX contenente i controlli e le bitmap di Windows Form, vedere Limitazioni dei controlli Windows Form nei documenti di Office.

In alcune condizioni il codice non viene caricato e viene visualizzata la sola bitmap, ad esempio quando la cartella di lavoro viene aperta dall'utente in modalità progettazione. Se poi la cartella di lavoro viene aperta dall'utente in un computer su cui non è installato il runtime di Visual Studio Tools per Office, i controlli non vengono caricati dal codice di personalizzazione ed è visibile solo la bitmap del controllo. Prima di salvare la cartella di lavoro e inviarla a un altro utente, è bene rimuovere sempre le informazioni personali dai controlli per essere certi che tali informazioni non vengano accidentalmente divulgate.

Aggiunta di componenti in fase di progettazione

Determinati controlli o componenti non sono visibili nel documento e sono invece visualizzati in una barra dei componenti. In Visual Studio Tools per Office viene fornita una barra dei componenti per ogni finestra di documento. La barra dei componenti viene visualizzata sullo schermo soltanto se nel documento sono presenti dei componenti.

Vedere anche

Attività

Procedura: aggiungere controlli Windows Form a documenti di Office

Procedura: ridimensionare i controlli nelle celle di un foglio di lavoro

Procedura: nascondere i controlli contenuti nei fogli di lavoro durante la stampa

Procedura dettagliata: modifica della formattazione dei fogli di lavoro mediante i controlli CheckBox

Procedura dettagliata: modifica della formattazione dei documenti mediante i controlli CheckBox

Procedura dettagliata: visualizzazione di testo in una casella di testo di un documento tramite un pulsante

Procedura dettagliata: visualizzazione di testo in una casella di testo di un foglio di lavoro tramite un pulsante

Concetti

Utilizzo di controlli Windows Form nei documenti di Word

Utilizzo di controlli Windows Form nei fogli di lavoro di Excel

Aggiunta di controlli ai documenti di Office in fase di esecuzione

Cenni preliminari sugli elementi e sui controlli host

Cenni preliminari sul riquadro delle azioni

Limitazioni dei controlli Windows Form nei documenti di Office

Riferimenti

ControlCollection.Remove

ControlCollection.Remove

Altre risorse

Controlli nei documenti di Office

Controlli per Windows Form

Cronologia delle modifiche

Date

History

Motivo

Luglio 2008

Aggiunte informazioni sull'aggiunta di controlli Windows Form ai documenti tramite componenti aggiuntivi a livello di applicazione.

Modifica di funzionalità in SP1.