DocumentList, classe

Mise à jour : novembre 2007

Représente un contrôle Pocket PC pour l'affichage et la gestion de documents de manière cohérente.

Espace de noms :  Microsoft.WindowsCE.Forms
Assembly :  Microsoft.WindowsCE.Forms (dans Microsoft.WindowsCE.Forms.dll)

Syntaxe

'Déclaration
Public Class DocumentList _
    Inherits Control
'Utilisation
Dim instance As DocumentList

public class DocumentList : Control

public ref class DocumentList : public Control

public class DocumentList extends Control

Notes

Un contrôle DocumentList fournit une implémentation managée du contrôle DocList Windows CE natif, le contrôle qui est visible, par exemple, lorsque vous démarrez Microsoft® Pocket Word et Microsoft® Pocket Excel. Ce contrôle offre les fonctionnalités suivantes :

• Sélectionner, supprimer, copier, déplacer et renommer des fichiers et des dossiers.

• Trier par nom, date ou taille de fichier.

• Envoyer des fichiers par courrier électronique.

• Envoyer des fichiers par infrarouge à un autre périphérique.

DocumentList est un contrôle plutôt qu'une boîte de dialogue complète telle que FileDialog. L'utilisation d'un contrôle DocumentList vous permet d'inclure des menus personnalisés ou d'autres contrôles dans votre interface utilisateur de sélection de fichiers.

DocumentList doit avoir la même largeur que le formulaire sur lequel il est placé. La longueur peut être celle que vous souhaitez.

DocumentList affiche uniquement les fichiers d'un dossier sélectionné dans la hiérarchie Mes documents.

Topic	Location
Comment : utiliser un contrôle DocumentList	.NET Compact Framework
Comment : utiliser un contrôle DocumentList	.NET Compact Framework
Comment : utiliser un contrôle DocumentList	.NET Compact Framework

Exemples

L'exemple de code suivant crée un contrôle DocumentList contenu dans Panel.

Imports System
Imports System.Drawing
Imports System.Collections
Imports System.Windows.Forms
Imports Microsoft.VisualBasic
Imports Microsoft.WindowsCE.Forms


Public Class Form1
   Inherits System.Windows.Forms.Form
    Friend WithEvents StatusBar1 As System.Windows.Forms.StatusBar
    Friend WithEvents DocumentList1 As Microsoft.WindowsCE.Forms.DocumentList

  Public Shared Sub Main()
    Application.Run(New Form1)
 End Sub

   Public Sub New()

      InitializeComponent()
      Me.MinimizeBox = false
      Me.DocumentList1 = New DocumentList

   'Set up file extension filters for a
   'DocumentList and set the initial folder
   'to the Busines folder under My Documents.
    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 


   Protected Overrides Sub Dispose(disposing As Boolean)
      MyBase.Dispose(disposing)
   End Sub 

   Private Sub InitializeComponent()
      Me.SuspendLayout()
        Me.StatusBar1 = New System.Windows.Forms.StatusBar
        '
        'StatusBar1
        '
        Me.StatusBar1.Location = New System.Drawing.Point(0,248)
        Me.StatusBar1.Size = New System.Drawing.Size(240,22)
        '
       '
      Me.Controls.Add(Me.StatusBar1)
      Me.Text = "DocList Demo"
      Me.ResumeLayout(False)
   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 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 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
End Class 

using System;
using System.Drawing;
using System.Windows.Forms;
using Microsoft.WindowsCE.Forms;

public class Form1 : Form
{
    private DocumentList DocList;
    private StatusBar statusBar1;

    public Form1()
    {
        // Create an instance of a DocumentList control.
        DocList = new DocumentList();

        // Create an instance of the event handler delegate
        // using a reference to the OnDocActivated method,
        // which handles the DocumentActivated event.
        // Add the delegate instance to the DocumentActivated event.
        DocList.DocumentActivated +=
           new DocumentListEventHandler(this.OnDocActivated);

        // Create an instance of the event handler delegate
        // using a reference to the OnFolderSel method,
        // which handles the SelectedDirectoryChanged event.
        // Add the delegate instance to the
        // SelectedDirectoryChanged event.
        DocList.SelectedDirectoryChanged +=
           new EventHandler(this.OnFolderSel);

        // Create an instance of the event handler delegate
        // using a reference to the OnDelDoc method,
        // which handles the DeletingDocument event.
        // Add the delegate instance to the
        // DeletingDocument event.
        DocList.DeletingDocument +=
           new DocumentListEventHandler(this.OnDelDoc);

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

        statusBar1 = new StatusBar();
        statusBar1.Parent = this;
        DocList.Parent = this;
        this.Text = "DocList Demo";

        // Display the OK button for closing the application.
        this.MinimizeBox = false;
    }
    private void OnDelDoc(object obj, DocumentListEventArgs docg)
    {
        statusBar1.Text += "Deleted: " + docg.Path;

        // Add code to close any instances of the file.
    }
    private void OnDocActivated(object obj, DocumentListEventArgs docg)
    {
        statusBar1.Text = "Activated: " + docg.Path;

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

        // Add code to access the selected folder to open and close files.
    }
    static void Main()
    {
        Application.Run(new Form1());
    }
}

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        Microsoft.WindowsCE.Forms.DocumentList

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plateformes

Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Compact Framework

Pris en charge dans : 3.5, 2.0

Voir aussi

Référence

Membres DocumentList

Microsoft.WindowsCE.Forms, espace de noms

Autres ressources

Comment : utiliser un contrôle DocumentList