Itens Recentes
A lista Itens Recentes é um painel no menu de aplicativo que exibe os itens mru (usados mais recentemente) para um aplicativo.
- Detalhes
- propriedades de itens recentes
- comentários
- tópicos relacionados
Detalhes
A captura de tela a seguir ilustra uma lista de itens recentes do WordPad para Windows 7).
A de Menu do Aplicativo pode ter no máximo um lista ApplicationMenu.RecentItems, representada por um elemento ApplicationMenu.RecentItems, para exibir documentos, imagens, filmes e outros projetos recentes 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 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.
Nota
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 de itens recentes do.
- 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á pela 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.
Nota
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 | Anotações |
|---|---|
| UI_PKEY_Keytip | Só pode ser atualizado por invalidação. |
| UI_PKEY_RecentItems | Só pode ser atualizado por invalidação. |
Observações
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 então ser usado pelo aplicativo para criar os dados exigidos pela estrutura da Faixa de Opções para preencher a lista itens recentes da menu de aplicativo.
Nota
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