Ostatnie elementy
Lista Ostatnio używane elementy to okienko w menu aplikacji , które wyświetla ostatnio używane elementy (MRU) dla aplikacji.
Szczegóły
Poniższy zrzut ekranu przedstawia listę Ostatnio używane elementy z programu WordPad dla systemu Windows 7.
menu aplikacji może zawierać co najwyżej jedną listęApplicationMenu.RecentItems reprezentowaną przez element ApplicationMenu.RecentItem s na potrzeby wyświetlania ostatnich dokumentów, obrazów, filmów i innych projektów, nad którymi pracuje użytkownik. Liczba wymienionych elementów waha się od zera do maksymalnej liczby określonej w adiustacji z wartością domyślną dziesięć. Ostatnie elementy są wyświetlane jako lista szeregowa ciągów wskazująca nazwy plików. Zaleca się użycie właściwościCommand.LabelDescription w celu nadania pełnej ścieżki lokalizacji pliku, jak pokazano na poniższym zrzucie ekranu.
Element RecentItems ma atrybut EnablePinning, który w przypadku ustawienia truewyświetla ikonę pinezki po prawej stronie każdego elementu na liście, jak pokazano na poniższym zrzucie ekranu.
Nuta
Przypinanie jest domyślnie włączone, jeśli nie określono atrybutu EnablePinning.
Algorytm przypinania ma na celu uniemożliwienie elementów spadających z listy Ostatnie elementy. Algorytm generuje następujące zachowanie:
- Nowy element jest zawsze dodawany w górnej części listy Ostatnie elementy.
- Elementy zostaną przeniesione w dół na liście w czasie. Gdy lista zostanie pełna (osiągnie maksymalną liczbę elementów określonych w znaczniku), starsze elementy spadną u dołu listy, ponieważ nowe elementy zostaną dodane na początku listy.
- Jeśli element już pojawi się gdzieś na liście, ale zostanie ponownie wyświetlony, zostanie on przeniesiony z powrotem do góry listy.
- Jeśli element jest przypięty, nadal będzie podróżować w dół listy, ale nie spadnie z dołu. Zamiast tego po zapełnieniu listy pierwszy odpięty element powyżej przypiętego elementu spadnie po dodaniu nowego elementu do listy.
- Jeśli liczba przypiętych elementów osiągnie maksymalną liczbę elementów, żadne nowe elementy nie zostaną dodane do listy, dopóki element nie zostanie przypięty.
Właściwości ostatnio używanych elementów
Struktura wstążki definiuje kolekcję kluczy właściwości dla kontrolki Ostatnie elementy.
Zazwyczaj właściwość Ostatnio używane elementy jest aktualizowana w interfejsie użytkownika wstążki, unieważniając polecenie skojarzone z kontrolką za pomocą wywołania metody IUIFramework::InvalidateUICommand. Zdarzenie unieważniania jest obsługiwane, a zdefiniowane właściwości są aktualizowane przez metodę wywołania zwrotnego IUICommandHandler::UpdateProperty wywołania zwrotnego.
Metoda wywołania zwrotnego IUICommandHandler::UpdateProperty nie jest wykonywana, a aplikacja odpytuje zaktualizowaną wartość właściwości, dopóki właściwość nie będzie wymagana przez strukturę. Na przykład po aktywowaniu karty i ujawnieniu kontrolki w interfejsie użytkownika wstążki lub po wyświetleniu etykietki narzędzia.
Nuta
W niektórych przypadkach właściwość można pobrać za pomocą metody IUIFramework::GetUICommandProperty i ustawić za pomocą metody IUIFramework::SetUICommandProperty.
W poniższej tabeli wymieniono klucze właściwości skojarzone z kontrolką Ostatnie elementy.
| Klucz właściwości | Notatki |
|---|---|
| UI_PKEY_Keytip | Można aktualizować tylko za pomocą unieważnienia. |
| UI_PKEY_RecentItems | Można aktualizować tylko za pomocą unieważnienia. |
Uwagi
Metoda IApplicationDocumentLists::GetList może służyć do pobierania listy narzędzi MRU powłoki systemu Windows dla aplikacji wstążki. Obiekt pobrany przez tę metodę może być następnie używany przez aplikację do tworzenia danych wymaganych przez strukturę wstążki w celu wypełnienia listy ostatnio używanych elementów menu aplikacji.
Nuta
W przypadku używania tej metody typ listy powinien mieć wartość ADLT_RECENT.
Aby zapoznać się z przykładem implementacji listy elementów MRU w aplikacji platformy wstążki, zobacz przykład HTMLEditRibbon Sample.
Tematy pokrewne