Compartir a través de


Agregar campos a una vista

En este ejemplo se muestra cómo personalizar una vista mediante el método Add(String) de la colección ViewFields para agregar campos a una vista.

Ejemplo

Nota:

El siguiente ejemplo de código es un fragmento de Aplicaciones de programación para Microsoft Office Outlook 2007.

Puede especificar qué propiedades de elemento de Outlook se muestran en una vista agregando una o más propiedades a la colección ViewFields solo para los objetos CardView y TableView. Para otros objetos View derivados como BusinessCardView, CalendarView, IconView y TimelineView use otros métodos para determinar qué propiedades del elemento de Outlook se muestran en la vista. Por ejemplo, los campos que se muestran para el objeto BusinessCardView se determinan según el diseño de tarjeta de presentación electrónica (EBC) asociado a cada elemento de Outlook mostrado.

Para obtener la colección ViewFields para una vista, use la propiedad ViewFields del objeto View asociado (por ejemplo, los objetos CardViewo TableView). El método Add de la colección ViewFields se utiliza para crear un objeto ViewField que representa la propiedad del elemento de Outlook que se muestra en la vista. Un objeto ViewField no solo identifica la propiedad de elemento de Outlook que se va a mostrar dentro de la vista, sino que también describe cómo se deben mostrar los valores de dicha propiedad. Puede cambiar cómo se muestran las propiedades de columna en una vista modificando la propiedad ColumnFormat del objeto ViewField.

En el ejemplo de código siguiente, ModifyMeetingRequestsView obtiene el objeto TableView que representa todas las vistas desde la Bandeja de entrada del usuario que son vistas de "Convocatorias de reunión". A continuación, en el ejemplo se usa el método Add para agregar los campos "Inicio" y "Fin" al objeto ViewFields corresponde al objeto TableView. También se cambia la etiqueta para el campo "De" a "Organizada por". A continuación, ModifyMeetingRequestsView, guarda el objeto TableView modificado.

Si usa Visual Studio para probar este ejemplo de código, primero debe agregar una referencia al componente de la biblioteca de objetos de Microsoft Outlook 15.0 y especificar la variable de Outlook al importar el espacio de nombres Microsoft.Office.Interop.Outlook. La instrucción using no debe producirse directamente antes de las funciones en el ejemplo de código, pero debe agregarse antes de la declaración de clase pública. La siguiente línea de código muestra cómo realizar la importación y la asignación en C#.

using Outlook = Microsoft.Office.Interop.Outlook;
private void ModifyMeetingRequestsView()
{
    Outlook.TableView tableView = null;
    Outlook.ViewField startField = null;
    Outlook.ViewField endField = null;
    Outlook.ViewField fromField = null;
    try
    {
        tableView =
            Application.Session.GetDefaultFolder(
            Outlook.OlDefaultFolders.olFolderInbox)
            .Views["Meeting Requests"] as Outlook.TableView;
    }
    catch { }
    if (tableView != null)
    {
        try
        {
            startField = tableView.ViewFields["Start"];
        }
        catch{}
        if (startField == null)
        {
            startField = tableView.ViewFields.Add("Start");
        }
        try
        {
            endField = tableView.ViewFields["End"];
        }
        catch{}
        if (endField == null)
        {
            endField = tableView.ViewFields.Add("End");
        }
        try
        {
            fromField = tableView.ViewFields["From"];
        }
        catch{}
        if (fromField != null)
        {
            fromField.ColumnFormat.Label = "Organized By";
        }
        try
        {
            tableView.Save();
        }
        catch (Exception ex)
        {
            Debug.WriteLine(ex.Message);
        }
    }
}

Vea también