Itens recentes
A lista Itens Recentes é um painel no Menu Aplicativo que exibe os itens usados mais recentemente (MRU) para um aplicativo.
Detalhes
A captura de tela a seguir ilustra uma lista de itens recentes do WordPad para Windows 7).
O Application Menu pode ter no máximo uma lista de ApplicationMenu.RecentItems, representada por um elemento ApplicationMenu.RecentItems, para exibir documentos, imagens, filmes e outros projetos recentes em que um usuário está trabalhando. O número de itens listados varia de zero ao número máximo especificado na marcação, com um valor padrão de dez. Os itens recentes são exibidos como uma lista numerada de cadeias de caracteres indicando nomes de arquivos. É recomendável que a propriedade Command.LabelDescription seja usada para fornecer o caminho completo para o local do arquivo, conforme mostrado na captura de tela a seguir.
O elementoRecentItems tem um atributo EnablePinning que, se definido como true, exibe um ícone de pino à direita de cada item da lista, conforme mostrado na captura de tela a seguir.
Observação
A fixação é habilitada por padrão se o atributo EnablePinning não for especificado.
O algoritmo de fixação destina-se a evitar que os itens caiam da lista itens recentes. O algoritmo produz o seguinte comportamento:
- Um novo item é sempre adicionado na parte superior da lista itens recentes.
- Os itens serão movidos para baixo na lista ao longo do tempo. Quando a lista estiver completa (atinge o número máximo de itens especificados na marcação), os itens mais antigos caem da parte inferior da lista à medida que novos itens são adicionados ao topo da lista.
- Se um item já aparecer em algum lugar da lista, mas for acessado novamente, ele voltará para o topo da lista.
- Se um item for fixado, ele ainda viajará para baixo na lista, mas não cairá da parte inferior. Em vez disso, quando a lista estiver cheia, o primeiro item não fixado acima do item fixado cairá quando um novo item for adicionado à lista.
- Se o número de itens fixados atingir o número máximo de itens, nenhum novo item será adicionado à lista até que um item seja removido.
Propriedades de itens recentes
A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle Itens Recentes.
Normalmente, uma propriedade Recent Items é atualizada na interface do usuário da faixa de opções invalidando o Command associado ao controle por meio de uma chamada para o método IUIFramework::InvalidateUICommand. O evento de invalidação é manipulado e as atualizações de propriedade definidas pelo método de retorno de chamada IUICommandHandler::UpdateProperty IUICommandHandler.
O IUICommandHandler::UpdateProperty método de retorno de chamada não é executado e o aplicativo consultado para obter um valor de propriedade atualizado, até que a propriedade seja exigida pela estrutura. Por exemplo, quando uma guia é ativada e um controle revelado na interface do usuário da faixa de opções ou quando uma dica de ferramenta é exibida.
Observação
Em alguns casos, uma propriedade pode ser recuperada através do método IUIFramework::GetUICommandProperty e definida com o IUIFramework::SetUICommandProperty método.
A tabela a seguir lista as chaves de propriedade associadas ao controle Itens recentes.
| Chave do imóvel | Observações |
|---|---|
| UI_PKEY_Keytip | Só pode ser atualizado através de invalidação. |
| UI_PKEY_RecentItems | Só pode ser atualizado através de invalidação. |
Comentários
O método IApplicationDocumentLists::GetList pode ser usado para recuperar a lista MRU do Shell do Windows para o aplicativo Ribbon. O objeto recuperado por esse método pode ser usado pelo aplicativo para criar os dados exigidos pela estrutura da Faixa de Opções para preencher os itens recentes lista do Menu do Aplicativo.
Observação
Ao usar esse método, listtype deve ter o valor ADLT_RECENT.
Para obter um exemplo de como implementar uma lista de itens MRU em um aplicativo de estrutura da Faixa de Opções, consulte a de exemplo HTMLEditRibbon .
Tópicos relacionados