Como: Usar um controle DocumentList

Artigo
08/25/2010

Se seu aplicativo for baseado no trabalho com arquivos, você pode usar um DocumentList controle para exibir uma lista personalizada de pastas e arquivos na pasta Meus documentos. Isso é semelhante a operar o Microsoft Pocket Word e o Microsoft Pocket Excel.O controle fornece ao usuário a seguinte funcionalidade:

Selecione, exclua, copie, mova, e renomeie arquivos e pastas.
Classifique por nome, data, ou tamanho de arquivo.
Envie arquivos como anexos de e-mail.
Envie arquivos via infravermelho para outro dispositivo.

Implementar um controle DocumentList

Criar um aplicativo Pocket PC Windows com um DocumentList.
Especifique os tipos de arquivo que podem ser acessados com o Filter propriedade.
Especifique os arquivos que são exibidos inicialmente com o FilterIndex propriedade.
Especifique uma pasta padrão com o SelectedDirectory propriedade.
Forneça o código para manipular o DocumentActivated evento.
Forneça o código para manipular o DeletingDocument evento.
Forneça o código para manipular o SelectedDirectoryChanged evento.

Exemplo

Este exemplo define o Parent propriedade para o DocumentList controle ao formulário, tornando-o ocupar a área inteira do cliente do formulário. Se você quiser que ele ocupe uma área menor, é possível colocá-la em um Panel e especifique o comprimento. A largura de um DocumentList deve ser a largura do formulário.

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

Compilando o código

Este exemplo requer referências aos seguintes namespaces:

Consulte também

Referência

DocumentList

Outros recursos

Desenvolvimento para Pocket PC e o .NET Compact Framework

Compartilhar via