panoramica dei controlli Windows Form nei documenti di Office

  • Articolo

I controlli Windows Form sono oggetti con cui gli utenti possono interagire per immettere o modificare i dati. Nei progetti a livello di documento per Microsoft Office Excel e Microsoft Office Word è possibile aggiungere controlli Windows Form al documento o alla cartella di lavoro nel progetto in fase di progettazione oppure aggiungere questi controlli a livello di codice in fase di esecuzione. È possibile aggiungere questi controlli a livello di codice a qualsiasi documento o foglio di lavoro aperto in fase di esecuzione in un componente aggiuntivo VSTO per Excel o Word.

Per altre informazioni, vedere Procedura: Aggiungere controlli Windows Form ai documenti di Office.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per Excel e Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Usare i controlli Windows Form

È possibile aggiungere controlli Windows Form ai documenti e agli elementi personalizzabili dell'interfaccia utente, tra cui riquadri azioni, riquadri attività personalizzati e Windows Form. I controlli Windows Form in genere hanno lo stesso comportamento nei documenti e in questi altri elementi dell'interfaccia utente, ma esistono 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 diversi fattori. Quando si progetta l'interfaccia utente della soluzione, tenere in considerazione gli usi dei controlli Windows Form descritti nella tabella seguente.

In un documento.

  • Per fare in modo che i controlli siano visualizzati costantemente.

  • Per consentire agli utenti di immettere dati direttamente nel documento, ad esempio in documenti basati su form in cui l'area di modifica è bloccata.

  • Per visualizzare i controlli in linea con i dati nel documento. Ad esempio, se si aggiungono pulsanti a ogni riga di un oggetto elenco, è consigliabile che siano allineati alle singole voci dell'elenco.

Nel riquadro azioni o in un riquadro attività personalizzato

  • Per fornire informazioni contestuali all'utente.

  • Per fare in modo che nel documento vengano visualizzati solo i risultati e non i controlli e i dati di query.

  • Per assicurarsi che i controlli non vengano stampati con il documento.

  • Per assicurarsi che i controlli non interferiscano con la visualizzazione del documento.

In un Windows Form

  • Per poter controllare le dimensioni dell'interfaccia utente.

  • Per impedire agli utenti di nascondere o eliminare i controlli.

  • Per ottenere l'input dall'utente e impedire a quest'ultimo di eseguire qualsiasi operazione nel documento fino a quando non viene ricevuto l'input.

Aggiungere controlli Windows Form a livello di codice

È possibile aggiungere controlli Windows Form a documenti di Word e fogli di lavoro di Excel in fase di esecuzione. Il Strumenti di Visual Studio per Office Runtime fornisce metodi helper per l'aggiunta dei controlli di Windows Form più comuni. Questi metodi helper consentono di aggiungere rapidamente controlli a un documento di Office e di accedere alle funzionalità combinate dei controlli Windows Form e alle funzionalità correlate a Office di questi controlli.

Per altre informazioni, vedere Aggiungere controlli ai documenti di Office in fase di esecuzione.

Usare i controlli Windows Form nei progetti a livello di documento

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

Creare controlli utente personalizzati

È possibile aggiungere un controllo utente al progetto e quindi aggiungerlo alla casella degli strumenti. È quindi possibile trascinare il controllo utente direttamente nel documento così come si aggiunge un controllo Windows Form a un documento. Esistono alcuni aspetti da tenere presenti quando si creano controlli utente:

  • Non creare un controllo utente sealed . Quando si trascina il controllo nel documento, Visual Studio genera una classe wrapper derivata dal controllo utente per estenderlo e supportarne l'uso nel documento. Se il controllo utente è sealed, Visual Studio non può generare la classe wrapper.

  • I controlli utente devono avere l'attributo ComVisibleAttribute impostato su true. Nei controlli utente creati all'interno di un progetto di Office questo attributo è impostato su true per impostazione predefinita, ma nei controlli utente che fanno parte di progetti esterni questo stesso attributo potrebbe non essere impostato su true.

  • Dopo aver aggiunto un controllo utente al documento, non rinominare o eliminare la classe UserControl dal progetto. Se è necessario rinominare un controllo utente, bisogna prima eliminarlo dal documento e quindi aggiungerlo di nuovo dopo aver cambiato il nome.

Disporre i controlli in fase di progettazione

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

Quando si selezionano più controlli nella finestra di progettazione, è possibile usare i pulsanti seguenti in queste barre degli strumenti per disporre i controlli:

  • Allinea a sinistra

  • Allinea al centro

  • Allinea a destra

  • Allinea in alto

  • Allinea in mezzo

  • Allinea in basso

  • Uniforma spaziatura orizzontale

  • Uniforma spaziatura verticale

Nota

Nei progetti di Word, questi pulsanti sono abilitati solo se i controlli selezionati non sono in linea con il testo. Per impostazione predefinita, i controlli aggiunti al documento in fase di progettazione sono in linea con il testo.

Impedisci la visualizzazione di dati obsoleti nelle cartelle di lavoro di Excel durante il caricamento

Quando si aggiungono controlli Windows Form a documenti o fogli di lavoro in fase di progettazione, i controlli rimangono nel documento quando l'utente chiude il documento. I controlli aggiunti in fase di progettazione sono anche definiti controlli statici.

Quando si apre una cartella di lavoro di Excel che contiene controlli statici, la cartella di lavoro mostra una bitmap del controllo in un controllo ActiveX fino a quando non viene eseguito il codice di personalizzazione e caricato il controllo effettivo. Excel crea questa bitmap e la archivia nella cartella di lavoro quando si salva la cartella di lavoro. La bitmap mostra l'aspetto del controllo al momento dell'ultimo salvataggio della cartella di lavoro, inclusi tutti i dati che vi erano visualizzati. Per altre informazioni sul controllo ActiveX che contiene Windows Form controlli e bitmap, vedere Limitazioni dei controlli Windows Form nei documenti di Office.

In determinate condizioni, il codice non viene caricato e viene visualizzata solo la bitmap, ad esempio quando l'utente apre la cartella di lavoro in modalità di progettazione. Inoltre, se l'utente apre la cartella di lavoro in un computer in cui non è installata la Strumenti di Visual Studio per il runtime di Office, la personalizzazione non può essere eseguita per caricare i controlli e pertanto è visibile solo la bitmap del controllo. È consigliabile rimuovere sempre le informazioni personali dai controlli nelle cartelle di lavoro prima di salvare una cartella di lavoro e inviarla a un altro utente per assicurarsi che le informazioni personali non vengano accidentalmente divulgate.

Associare le dimensioni del controllo alle dimensioni delle celle in un foglio di lavoro di Excel

È possibile impostare il ridimensionamento automatico del controllo quando vengono modificate le dimensioni della cella padre. Per altre informazioni, vedere Procedura: Ridimensionare i controlli all'interno delle celle del foglio di lavoro.

Aggiungere componenti condivisi da tutti i fogli di lavoro

I componenti da condividere in tutti i fogli di lavoro, ad esempio un oggetto DataSet, possono essere aggiunti alla finestra di progettazione delle cartelle di lavoro anziché ai fogli di lavoro. Il componente verrà visualizzato nella barra dei componenti.

Formula per l'incorporamento di controlli in un foglio di lavoro di Excel

Quando si seleziona un controllo in Excel, verrà visualizzato =EMBED("WinForms.Control.Host","") nella Barra della formula. Questo testo è necessario e non deve essere eliminato.

Stile di layout dei controlli in un documento di Word

Quando si aggiunge un controllo al documento di Word in un progetto a livello di documento usando la finestra di progettazione di Visual Studio, il controllo viene aggiunto in linea con il testo. Per modificare lo stile di layout del controllo, fare clic con il pulsante destro del mouse sul controllo e scegliere Formato controllo. Selezionare uno stile nella pagina Layout della finestra di dialogo Formato oggetto .

Quando si aggiunge un controllo a un documento di Word in fase di esecuzione, è possibile specificare lo stile di layout del nuovo controllo utilizzando overload diversi Add<del metodo della ControlCollection classe> di controllo:

  • Per aggiungere il controllo in linea con testo, usare un overload che accetta un oggetto Range che specifica la posizione del controllo.

  • Per aggiungere il controllo come forma mobile, usare un overload che accetta la coordinata superiore e la coordinata sinistra del controllo.

    Per altre informazioni, vedere Aggiungere controlli ai documenti di Office in fase di esecuzione.

    Se si apre un modello di Word nella finestra di progettazione di Visual Studio, i controlli non inline nel modello potrebbero non essere visibili perché Visual Studio apre il modello in visualizzazione Normale . Per visualizzare i controlli, modificare la visualizzazione in Layout di stampa.

Controlli esterni al corpo del documento principale

I controlli Windows Form non sono supportati all'interno di un'intestazione o piè di pagina o di un documento secondario.

Aggiungere componenti in fase di progettazione

Alcuni controlli o componenti non sono visibili nel documento e vengono invece visualizzati in una barra dei componenti. Visual Studio fornisce una barra dei componenti per ogni finestra del documento. La barra dei componenti viene visualizzata solo se sono presenti componenti nel documento.

Contenuto correlato