Procedura dettagliata: creazione di controlli utente per dispositivi

Articolo
09/12/2008

Aggiornamento: novembre 2007

In questa procedura dettagliata viene illustrato come creare una libreria di controlli e aggiungere un nuovo controllo utente in tale libreria. Vengono illustrate le differenze tra un controllo utente, ossia una combinazione di controlli Windows Form in una singola unità riutilizzabile, e un controllo personalizzato, ossia un controllo che richiede un'interfaccia utente o funzionalità non disponibili tramite i controlli standard.

Il controllo utente di questa procedura dettagliata è una semplice orologio da visualizzare nei dispositivi e si basa su procedure dettagliate per desktop simili, ad esempio Procedura dettagliata: modifica di un controllo composito con Visual Basic e Procedura dettagliata: modifica di un controllo composito con Visual C#.

La procedura dettagliata è costituita da quattro attività principali:

Creazione di una libreria di controlli e di un controllo.
Ridenominazione della libreria e del controllo.
Aggiunta di componenti al controllo.
Test del controllo sull'emulatore di dispositivo.

Per questa procedura dettagliata è possibile utilizzare Visual Basic o Visual C# . Se in entrambi i linguaggi viene utilizzato lo stesso nome file con un'estensione specifica del linguaggio, una barra verticale segnala che è necessario scegliere l'estensione relativa al linguaggio che si sta utilizzando, come in nomefile.vb|cs.

Nota:
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Questa procedura dettagliata è stata scritta utilizzando Impostazioni di sviluppo di Visual Basic e Impostazioni di sviluppo di Visual C#.

Prerequisiti

Nessuno.

Scelta di un dispositivo di destinazione

Per assicurarsi che venga chiesto di selezionare un dispositivo al momento della distribuzione della soluzione, attenersi alla procedura che segue.

Per visualizzare un elenco di dispositivi in fase di distribuzione

Scegliere Opzioni dal menu Strumenti, espandere Strumenti dispositivo, quindi fare clic su Generale.

Se la voce Strumenti dispositivo non è visualizzata, selezionare Mostra tutte le impostazioni nella parte inferiore della finestra di dialogo Opzioni.
Selezionare la casella di controllo Mostra opzioni dispositivi prima di distribuire un progetto per dispositivo.

Creazione del progetto

Il nome assegnato a un nuovo progetto viene utilizzato anche per impostare lo spazio dei nomi radice e il nome dell'assembly.

Per creare la libreria di controlli e il controllo

(Visual Basic) Scegliere Nuovo progetto dal menu File.

oppure

(Visual C#) Scegliere Nuovo dal menu File, quindi scegliere Progetto.
Nel riquadro Tipi progetto della finestra di dialogo Nuovo progetto espandere Visual Basic o Visual C#, quindi fare clic su Smart Device.

Se il linguaggio desiderato non è visualizzato, espandere Altri linguaggi. La visualizzazione è determinata dalle impostazioni di sviluppo.
Nel riquadro Modelli selezionare Progetto Smart Device.
Nella casella Nome digitare ctlDevClockLib, quindi scegliere OK.
(Solo per Visual C#) Nella casella Percorso verificare il percorso per l'archiviazione dei file di progetto, quindi scegliere OK.
Nell'elenco a discesa Piattaforma di destinazione selezionare Pocket PC 2003.
Selezionare .NET Compact Framework Versione 2.0 nell'elenco a discesa Versione di .NET Compact Framework.
Nel riquadro Modelli fare clic su Libreria di controlli, quindi scegliere OK.

Verrà visualizzata la finestra Progettazione componenti.

Sebbene il nome progetto, lo spazio nomi principale e il nome dell'assembly (ctlDevClockLib) siano stati già specificati, Ai componenti del progetto vengono tuttavia assegnati nomi predefiniti da Visual Studio, ad esempio, UserControl1. In genere si preferisce modificare questi nomi con termini più efficaci.

Per rinominare la libreria e il controllo

In Esplora soluzioni fare clic con il pulsante destro del mouse su UserControl1.vb|cs, quindi scegliere Proprietà.
Modificare il campo Nome file in ctlDevClock.vb|cs.
(Solo Visual C#) Nella finestra del messaggio in cui viene chiesto se si desidera rinominare tutti i riferimenti a questo elemento di codice, scegliere Sì.

La modifica del nome nella finestra Proprietà verrà propagata agli altri riferimenti, ad esempio il costruttore e il nome della classe.

Successivamente, aggiungere i componenti della Casella degli strumenti per fornire al controllo utente le funzionalità e l'interazione utente. In questa procedura guidata, vengono aggiunti un controllo Timer per accedere all'ora di sistema e un controllo Label per visualizzare l'ora.

Per aggiungere i componenti e modificarne le proprietà

Nella Casella degli strumenti, fare doppio clic su Label.

In Progettazione componenti viene aggiunto un controllo label al controllo utente.
Nella finestra Proprietà relativa al controllo label, effettuare le seguenti operazioni:

Proprietà	Modificare in
Name	lblDisplay
Text	(vuoto)
TextAlign	TopCenter
Font.Size	14

Nella Casella degli strumenti, fare doppio clic su Timer.

Nella barra dei componenti verrà visualizzato un controllo Timer.
Nella finestra Proprietà relativa al controllo timer, effettuare le seguenti operazioni:

Proprietà	Modificare in
Interval	1000
Enabled	True

Nei passaggi riportati di seguito viene aggiunto un gestore eventi per visualizzare gli scatti dell'orologio nel controllo Label.

Per aggiungere un gestore eventi

Sulla barra dei componenti fare doppio clic su Timer1 (Visual Basic) o su timer1 (C#) per aprire l'editor di codice in corrispondenza dell'evento Tick.
(Visual Basic) Inserire il codice di gestione degli eventi riportato di seguito:
```
lblDisplay.Text = Format(Now, "hh:mm:ss")
```
oppure

(Visual C#)
```
lblDisplay.Text = DateTime.Now.ToLongTimeString();
```

(Visual Basic) Cambiare il modificatore di accesso da Private a Protected e aggiungere la parola chiave Overridable, in modo che il codice del gestore sia simile a quello riportato di seguito:

Protected Overridable Sub Timer1_Tick(ByVal sender As Object, _
   ByVal e As System.EventArgs) Handles Timer1.Tick
   ' Causes the label to display the current time  
   lblDisplay.Text = Format(Now, "hh:mm:ss")
End Sub

oppure

(Visual C#) Cambiare il modificatore di accesso da private a protected e aggiungere la parola chiave virtual, in modo che il codice del gestore sia simile a quello riportato di seguito:

protected virtual void timer1_Tick(object sender, System.EventArgs
   e)
{
   // Causes the label to display the current time.
   lblDisplay.Text = DateTime.Now.ToLongTimeString(); 
}

Scegliere Salva tutto dal menu File.
(Solo per Visual Basic) Nella finestra di dialogo Salva progetto salvare il progetto come ctlDevClockLib nel percorso desiderato.

Test del controllo

Questa semplice applicazione per dispositivi funziona da strumento Test Container per il controllo.

Per compilare il controllo e creare uno strumento Test Container

Scegliere Compila (o Compila ctlDevClockLib) dal menu Compila.
Scegliere Aggiungi dal menu File, quindi fare clic su Nuovo progetto.
Nella finestra di dialogo Aggiungi nuovo progetto fare clic su Smart Device nel riquadro Tipi progetto, quindi fare clic su Progetto Smart Device nel riquadro Modelli.
Nella casella Nome digitare Test, quindi scegliere OK.
Nella finestra di dialogo Aggiungi nuovo progetto Smart Device selezionare Pocket PC 2003 nell'elenco a discesa Piattaforma di destinazione, selezionare .NET Compact Framework Versione 2.0 nell'elenco a discesa .NET Compact Framework, fare clic su Applicazione dispositivo nel riquadro Modelli, quindi scegliere OK.
In Esplora soluzioni, fare clic con il pulsante destro del mouse sul progetto Test, quindi fare clic su Imposta come progetto di avvio.
Fare clic con il pulsante destro del mouse sul progetto Test, quindi scegliere Aggiungi riferimento.
Nella finestra di dialogo Aggiungi riferimento, fare clic sulla scheda Progetti, quindi fare doppio clic su ctlDevClockLib.
Nella Casella degli strumenti, individuare la scheda Componenti ctlDevClockLib, quindi fare doppio clic sul componente ctlDevClock.

Il controllo viene caricato nella finestra di progettazione.
Scegliere Avvia o Avvia debug dal menu Debug.
Nella finestra di dialogo Distribuisci, selezionare Pocket PC 2003 SE - Emulatore, quindi scegliere Distribuisci.

Share via