DocumentList (Clase)
Actualización: noviembre 2007
Representa un control de Pocket PC para mostrar y administrar documentos de manera coherente.
Espacio de nombres: Microsoft.WindowsCE.Forms
Ensamblado: Microsoft.WindowsCE.Forms (en Microsoft.WindowsCE.Forms.dll)
Sintaxis
'Declaración
Public Class DocumentList _
Inherits Control
'Uso
Dim instance As DocumentList
public class DocumentList : Control
public ref class DocumentList : public Control
public class DocumentList extends Control
Comentarios
Un control DocumentList proporciona una implementación administrada del control DocList nativo de Windows CE, el control que es visible, por ejemplo, al iniciar Microsoft® Pocket Word o Microsoft® Pocket Excel. Este control proporciona la funcionalidad siguiente:
Seleccionar, eliminar, copiar, mover y cambiar el nombre de archivos y carpetas.
Ordenar por nombre de archivo, fecha o tamaño.
Archivos de correo electrónico.
Enviar archivos por infrarrojos a otro dispositivo.
Un DocumentList es más bien un control que un cuadro de diálogo completo como FileDialog. El uso de un control DocumentList permite incluir menús personalizados u otros controles en la interfaz de usuario de selección de archivos.
Un control DocumentList debería tener el mismo ancho que el formulario en el que se coloca. La longitud puede extenderse todo lo necesario.
Un control DocumentList sólo muestra los archivos de una carpeta seleccionada en la jerarquía de Mis documentos .
Topic | Location |
---|---|
Cómo: Utilizar un control DocumentList | .NET Compact Framework |
Cómo: Utilizar un control DocumentList | .NET Compact Framework |
Cómo: Utilizar un control DocumentList | .NET Compact Framework |
Ejemplos
El ejemplo de código siguiente crea un control DocumentList contenido en un 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());
}
}
Jerarquía de herencia
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
Microsoft.WindowsCE.Forms.DocumentList
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Plataformas
Windows Mobile para Pocket PC
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Información de versión
.NET Compact Framework
Compatible con: 3.5, 2.0
Vea también
Referencia
Microsoft.WindowsCE.Forms (Espacio de nombres)