Itens recentes
A lista Itens Recentes é um painel no Menu do Aplicativo que exibe os itens mru (usados mais recentemente) para um aplicativo.
Detalhes
A captura de tela a seguir ilustra uma lista Itens Recentes do WordPad para Windows 7).
O Menu do Aplicativo pode ter no máximo uma lista ApplicationMenu.RecentItems , representada por um elemento ApplicationMenu.RecentItems , para exibir documentos recentes, imagens, filmes e outros projetos em que um usuário vem 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 que indicam nomes de arquivo. É 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 elemento RecentItems tem um atributo EnablePinning que, se definido como true, exibe um ícone de pino à direita de cada item na lista, conforme mostrado na captura de tela a seguir.
Observação
A fixação será habilitada por padrão se o atributo EnablePinning não for especificado.
O algoritmo de fixação destina-se a impedir 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. Depois que a lista estiver completa (atingir o número máximo de itens especificados na marcação), os itens mais antigos cairão da parte inferior da lista à medida que novos itens são adicionados à parte superior da lista.
- Se um item já aparecer em algum lugar da lista, mas for acessado novamente, ele voltará para a parte superior da lista.
- Se um item estiver 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 desafixado 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 desafixado.
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 Itens Recentes é atualizada na interface do usuário da faixa de opções invalidando o Comando associado ao controle por meio de uma chamada para o método IUIFramework::InvalidateUICommand . O evento de invalidação é tratado e as atualizações de propriedade definidas pelo método de retorno de chamada IUICommandHandler::UpdateProperty .
O método de retorno de chamada IUICommandHandler::UpdateProperty não é executado e o aplicativo consultou 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 por meio do método IUIFramework::GetUICommandProperty e definida com o método IUIFramework::SetUICommandProperty .
A tabela a seguir lista as chaves de propriedade associadas ao controle Itens Recentes.
| Chave de Propriedade | Observações |
|---|---|
| UI_PKEY_Keytip | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_RecentItems | Só pode ser atualizado por meio 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 a lista Itens recentes 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 de MRU em um aplicativo de estrutura da Faixa de Opções, consulte o exemplo HTMLEditRibbon.
Tópicos relacionados