Procedura: utilizzare un controllo DocumentList

Articolo
09/12/2008

Aggiornamento: novembre 2007

Se l'applicazione prevede la gestione di file, è possibile utilizzare un controllo DocumentList per visualizzare un elenco personalizzato di cartelle e file nella cartella Documenti, con modalità simili a quelle supportate da Microsoft Pocket Word e Microsoft Pocket Excel. Il controllo fornisce all'utente le funzionalità descritte di seguito:

Selezionare, eliminare, copiare, spostare e rinominare file e cartelle.
Ordinare in base al nome, alla data o alla dimensione dei file.
Inviare file come allegati di posta elettronica.
Inviare file a un altro dispositivo tramite la connessione a infrarossi.

Per implementare un controllo DocumentList

Creare un'applicazione Windows Pocket PC con una classe DocumentList.
Specificare i tipi di file accessibili con la proprietà Filter.
Specificare i file inizialmente visualizzati con la proprietà FilterIndex.
Specificare una cartella predefinita con la proprietà SelectedDirectory.
Fornire il codice per la gestione dell'evento DocumentActivated.
Fornire il codice per la gestione dell'evento DeletingDocument.
Fornire il codice per la gestione dell'evento SelectedDirectoryChanged.

Esempio

Nell'esempio, la proprietà Parent per il controllo DocumentList viene impostata sul form in modo da occupare l'intera area client del form. Se si desidera occupare un'area più piccola, è possibile inserirla in una classe Panel e specificare la lunghezza. La larghezza di una classe DocumentList deve corrispondere a quella del form.

 ' Set up file extension filters for a
 ' DocumentList and set the initial folder
 ' to the Busines folder under My Documents.
 Sub SetupDocList()

     ' Assumes an instance of DocumentList,
     ' documentList1, has been declared.
     With DocumentList1
         .Parent = Me
         .Filter = " |*.*| |*.txt;*.xml| |*.pwi;*.pdt| " & _
             "|*.pxl;*.psw| |*.jpg;*.gif;*.bmp| |*.wav;*.wmv;*.mpg;"
         .FilterIndex = 0
         .SelectedDirectory = "Business"
     End With

 End Sub

' Handle the DocumentedActivated
' event with code to open the file.
 Private Sub DocList_DocumentActivated(ByVal sender As Object, _
     ByVal docevent As Microsoft.WindowsCE.Forms.DocumentListEventArgs) _
     Handles DocumentList1.DocumentActivated

     StatusBar1.Text = "Activated: " & docevent.Path
 ' Add code to open the selected file.

 End Sub

 ' Handle the DeletingDocument 
 ' event with code to close the file.
 Private Sub DocList_DeletingDocument(ByVal sender As Object, _
     ByVal docevent As Microsoft.WindowsCE.Forms.DocumentListEventArgs) _
     Handles DocumentList1.DeletingDocument

     StatusBar1.Text = "Deleted: " & docevent.Path
     ' Add code to close any instances of the file.

 End Sub

 ' Handle the SelectedDirectoryChanged
 ' event with code that sets the correct
 ' path for opening and closing files.
 Private Sub DocList_SelectedDirectoryChanged( _
     ByVal sender As Object,  ByVal e As System.EventArgs) _
     Handles DocumentList1.SelectedDirectoryChanged

     StatusBar1.Text = "Folder: " & DocumentList1.SelectedDirectory
     ' Add code to access the selected folder to open and close files.    

 End Sub

// Set up file extension filters for a
// DocumentList and set the initial folder
// to the Busines folder under My Documents.
 private void SetupDocList()
 {

     // Assumes an instance of DocumentList,
     // documentList1, has been declared.
     documentList1.Parent = this;

     // Create event handlers for DocumentList events.
     documentList1.DocumentActivated +=
         new DocumentListEventHandler(this.OnDocActivated);

     documentList1.SelectedDirectoryChanged +=
         new EventHandler(this.OnFolderSel);

     documentList1.DeletingDocument +=
         new DocumentListEventHandler(this.OnDelDoc);

     documentList1.Filter = " |*.*| |*.txt;*.xml| |*.pwi;*.pdt| " +
         "|*.pxl;*.psw| |*.jpg;*.gif;*.bmp| |*.wav;*.wmv;*.mpg;";
     documentList1.FilterIndex = 0;
     documentList1.SelectedDirectory = "Business";
 }

 private void OnDelDoc(object obj, DocumentListEventArgs DocArgs)
 {
     statusBar1.Text += "Deleted: " + DocArgs.Path;

     // Add code to close any instances of the file.
 }

 private void OnDocActivated(object obj, DocumentListEventArgs DocArgs)
 {
     statusBar1.Text = "Activated: " + DocArgs.Path;

     // Add code to open the selected file.
 }
 private void OnFolderSel(object obj, EventArgs eventg)
 {
     statusBar1.Text = "Folder: " + documentList1.SelectedDirectory;

     // Add code to access the selected folder to open and close files.
 }

Compilazione del codice

Questo esempio richiede riferimenti ai seguenti spazi dei nomi:

Vedere anche

Riferimenti

DocumentList

Altre risorse

Sviluppo per Pocket PC e .NET Compact Framework

Condividi tramite