Share via

Elementos recientes

  • Artículo

La lista Elementos recientes es un panel en el menú aplicación que muestra los elementos usados más recientemente (MRU) de una aplicación.

Detalles

En la captura de pantalla siguiente se muestra una lista de elementos recientes de WordPad para Windows 7).

captura de pantalla de la lista de elementos recientes en la cinta de microsoft paint.

El menú de aplicación puede tener como máximo una lista ApplicationMenu.RecentItems , representada por un elemento ApplicationMenu.RecentItems , para mostrar documentos recientes, imágenes, películas y otros proyectos en los que un usuario ha estado trabajando. El número de elementos enumerados va de cero al número máximo especificado en el marcado, con un valor predeterminado de diez. Los elementos recientes se muestran como una lista numerada de cadenas que indican nombres de archivo. Se recomienda usar la propiedad Command.LabelDescription para proporcionar la ruta de acceso completa para la ubicación del archivo, como se muestra en la captura de pantalla siguiente.

captura de pantalla de una lista de elementos recientes en un menú de la aplicación.

El elemento RecentItems tiene un atributo EnablePinning que, si se establece trueen , muestra un icono de anclaje a la derecha de cada elemento de la lista, como se muestra en la captura de pantalla siguiente.

Nota

El anclaje está habilitado de forma predeterminada si no se especifica el atributo EnablePinning .

 

captura de pantalla de los elementos recientes anclados en un menú de la aplicación.

El algoritmo de anclaje está pensado para evitar que los elementos se desactiven de la lista De elementos recientes . El algoritmo genera el siguiente comportamiento:

  • Siempre se agrega un nuevo elemento en la parte superior de la lista Elementos recientes .
  • Los elementos se desplazarán hacia abajo en la lista con el tiempo. Una vez que la lista está llena (alcanza el número máximo de elementos especificados en el marcado), los elementos más antiguos se encuentran fuera de la parte inferior de la lista a medida que se agregan nuevos elementos a la parte superior de la lista.
  • Si un elemento ya aparece en algún lugar de la lista, pero se vuelve a acceder a él, vuelve a la parte superior de la lista.
  • Si un elemento está anclado, seguirá desplazando hacia abajo la lista, pero no caerá fuera de la parte inferior. En su lugar, una vez que la lista está llena, el primer elemento desanclado por encima del elemento anclado caerá cuando se agregue un nuevo elemento a la lista.
  • Si el número de elementos anclados alcanza el número máximo de elementos, no se agregará ningún nuevo elemento a la lista hasta que se desenpinte un elemento.

Propiedades de elementos recientes

El marco de la cinta define una colección de claves de propiedad para el control Elementos recientes.

Normalmente, una propiedad Elementos recientes se actualiza en la interfaz de usuario de la cinta invalidando el comando asociado al control a través de una llamada al método IUIFramework::InvalidateUICommand . El evento de invalidación se controla y la propiedad se actualiza definida por el método de devolución de llamada IUICommandHandler::UpdateProperty .

El método de devolución de llamada IUICommandHandler::UpdateProperty no se ejecuta y la aplicación consulta para obtener un valor de propiedad actualizado, hasta que el marco requiera la propiedad. Por ejemplo, cuando se activa una pestaña y se muestra un control en la interfaz de usuario de la cinta de opciones, o cuando se muestra una información sobre herramientas.

Nota

En algunos casos, se puede recuperar una propiedad a través del método IUIFramework::GetUICommandProperty y establecer con el método IUIFramework::SetUICommandProperty .

 

En la tabla siguiente se enumeran las claves de propiedad asociadas al control Elementos recientes.

Clave de propiedad Notas
UI_PKEY_Keytip Solo se puede actualizar a través de la invalidación.
UI_PKEY_RecentItems Solo se puede actualizar a través de la invalidación.

 

Comentarios

El método IApplicationDocumentLists::GetList se puede usar para recuperar la lista mrU de Shell de Windows para la aplicación ribbon. Después, la aplicación puede usar el objeto recuperado por este método para crear los datos requeridos por el marco de cinta de opciones para rellenar la lista elementos recientes del menú aplicación.

Nota

Al usar este método, listtype debe tener el valor ADLT_RECENT.

 

Para obtener un ejemplo de cómo implementar una lista de elementos mrU en una aplicación de marco de cinta de opciones, consulte el ejemplo HTMLEditRibbon.

Biblioteca de controles del marco de la cinta de opciones de Windows

Elemento de marcado de elementos recientes