SO WIRD'S GEMACHT: Verwenden eines DocumentList-Steuerelements

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Wenn Ihre Anwendung auf das Arbeiten mit Dateien basiert, können Sie ein DocumentList-Steuerelement verwenden, um eine benutzerdefinierte Liste von Ordnern und Dateien im Ordner Eigene Dateien anzuzeigen. Dies ähnelt der Funktionsweise von Microsoft Pocket Word und Microsoft Pocket Excel. Das Steuerelement bietet den Benutzer die folgenden Funktionen:

  • Auswählen, löschen, kopieren, verschieben und Umbenennen von Dateien und Ordnern.

  • Sortieren nach Dateiname, Datum oder Größe.

  • Senden Sie Dateien als e-Mail-Anlagen.

  • Senden Sie Dateien von Infrarot an ein anderes Gerät.

Um ein DocumentList-Steuerelement implementieren

  1. Erstellen Sie eine Pocket PC-Windows-Anwendung mit einer DocumentList.

  2. Geben Sie die Dateitypen, auf die zugegriffen werden kann, mit der Eigenschaft Filter.

  3. Geben Sie die Dateien, die zunächst angezeigt werden mit der Eigenschaft FilterIndex.

  4. Geben Sie einen Standardordner mit der Eigenschaft SelectedDirectory.

  5. Stellen Sie Code für die Ereignisbehandlung DocumentActivated bereit.

  6. Stellen Sie Code für die Ereignisbehandlung DeletingDocument bereit.

  7. Stellen Sie Code für die Ereignisbehandlung SelectedDirectoryChanged bereit.

Beispiel

In diesem Beispiel wird die Parent -Eigenschaft für das Steuerelement DocumentList dem Formular, wodurch es den gesamten Clientbereich des Formulars einnimmt. Wenn Sie darauf, um einen kleineren Bereich belegen möchten, können Sie versehen eine Panel und geben Sie die Länge. Die Breite des ein DocumentList sollte die Breite des Formulars sein.

                         ' 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"EndWithEndSub
' Handle the DocumentedActivated' event with code to open the file.PrivateSub DocList_DocumentActivated(ByVal sender AsObject, _
     ByVal docevent As Microsoft.WindowsCE.Forms.DocumentListEventArgs) _
     Handles DocumentList1.DocumentActivated

     StatusBar1.Text = "Activated: " & docevent.Path
 ' Add code to open the selected file.EndSub
 ' Handle the DeletingDocument  ' event with code to close the file.PrivateSub DocList_DeletingDocument(ByVal sender AsObject, _
     ByVal docevent As Microsoft.WindowsCE.Forms.DocumentListEventArgs) _
     Handles DocumentList1.DeletingDocument

     StatusBar1.Text = "Deleted: " & docevent.Path
     ' Add code to close any instances of the file.EndSub
 ' Handle the SelectedDirectoryChanged ' event with code that sets the correct ' path for opening and closing files.PrivateSub DocList_SelectedDirectoryChanged( _
     ByVal sender AsObject,  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.    EndSub
                        // 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";
 }

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

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

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

     // Add code to open the selected file.
 }
 privatevoid 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

In diesem Beispiel sind Verweise auf die folgenden Namespaces erforderlich:

Siehe auch

Referenz

DocumentList

Weitere Ressourcen

Pocket PC-Entwicklung und .NET Compact Framework