Gewusst wie: Verwenden eines DocumentList-Steuerelements

Artikel
09/02/2008

Aktualisiert: November 2007

Wenn die Anwendung auf der Arbeit mit Dateien basiert, können Sie mit einem DocumentList-Steuerelement eine benutzerdefinierte Liste von Ordnern und Dateien im Ordner "Eigene Dateien" anzeigen. Diese Vorgehensweise weist Ähnlichkeiten mit der Funktionsweise von Microsoft Pocket Word und Microsoft Pocket Excel auf. Das Steuerelement stellt dem Benutzer die folgende Funktionalität zur Verfügung:

Auswählen, Löschen, Kopieren, Verschieben und Umbenennen von Dateien und Ordnern
Sortieren nach Dateiname, Datum oder Größe
Senden von Dateien als E-Mail-Anlagen
Senden von Dateien über eine Infrarotverbindung an ein anderes Gerät

So implementieren Sie ein DocumentList-Steuerelement

Erstellen Sie eine Pocket PC-Windows-Anwendung mit DocumentList.
Geben Sie mit der Filter-Eigenschaft die Dateitypen an, auf die zugegriffen werden kann.
Geben Sie mit der FilterIndex-Eigenschaft die Dateien an, die anfangs angezeigt werden.
Geben Sie mit der SelectedDirectory-Eigenschaft einen Standardordner an.
Schreiben Sie Code zur Handhabung des DocumentActivated-Ereignisses.
Schreiben Sie Code zur Handhabung des DeletingDocument-Ereignisses.
Schreiben Sie Code zur Handhabung des SelectedDirectoryChanged-Ereignisses.

Beispiel

In diesem Beispiel wird die Parent-Eigenschaft für das DocumentList-Steuerelement des Formulars so festgelegt, dass es den gesamten Innenbereich des Formulars belegt. Wenn das Steuerelement weniger Platz in Anspruch nehmen soll, platzieren Sie es in einem Panel und geben die gewünschte Länge an. Die Breite einer DocumentList sollte der Breite des Formulars entsprechen.

 ' 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.
 }

Kompilieren des Codes

Für dieses Beispiel sind Verweise auf die folgenden Namespaces erforderlich:

Siehe auch

Referenz

DocumentList

Weitere Ressourcen

Pocket PC-Entwicklung und .NET Compact Framework

Freigeben über