Galeria przycisków podziału
Galeria przycisków podziału jest kontrolką złożoną zawierającą przycisk podstawowy, który uwidacznia pojedynczy element domyślny lub polecenie, oraz przycisk pomocniczy, który po kliknięciu wyświetla resztę elementu lub kolekcji Poleceń na wzajemnie wykluczanej liście rozwijanej.
Szczegóły
Ta kontrolka jest przydatna do uwidaczniania ściśle powiązanych elementów w przypadkach, gdy jest dostępna oczywista wartość domyślna i gdzie poszczególne elementy mogą być reprezentowane przez obraz, tekst lub oba te elementy.
Poniższy zrzut ekranu przedstawia galerię przycisków podziału wstążki w programie Microsoft Paint.
Właściwości galerii przycisków podziału
Struktura wstążki definiuje kolekcję kluczy właściwości dla kontrolki Galeria przycisków podziału.
Zazwyczaj właściwość Galeria przycisków podziału jest aktualizowana w interfejsie użytkownika wstążki przez unieważnienie polecenia skojarzonego 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ą Galeria przycisków podziału.
| Klucz właściwości | Notatki |
|---|---|
| UI_PKEY_BooleanValue | Obsługuje IUIFramework::GetUICommandProperty i IUIFramework::SetUICommandProperty. |
| UI_PKEY_Categories | Obsługuje IUIFramework::GetUICommandProperty i IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Obsługuje IUIFramework::GetUICommandProperty i IUIFramework::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Obsługuje IUIFramework::GetUICommandProperty i IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Można aktualizować tylko za pomocą unieważnienia. |
| UI_PKEY_Label | Można aktualizować tylko za pomocą unieważnienia. |
| UI_PKEY_LargeHighContrastImage | Można aktualizować tylko za pomocą unieważnienia. |
| UI_PKEY_LargeImage | Można aktualizować tylko za pomocą unieważnienia. |
|
UI_PKEY_SelectedItem(tylko prawidłowa dla galerii elementów) |
Obsługuje IUIFramework::GetUICommandProperty i IUIFramework::SetUICommandProperty.
Uwaga: Jeśli polecenie skojarzone z kontrolką jest unieważnione za pośrednictwem wywołania IUIFramework::InvalidateUICommand, struktura wykonuje zapytanie o tę właściwość, gdy UI_INVALIDATIONS_VALUE jest przekazywana jako wartość flag . |
| UI_PKEY_SmallHighContrastImage | Można aktualizować tylko za pomocą unieważnienia. |
| UI_PKEY_SmallImage | Można aktualizować tylko za pomocą unieważnienia. |
| UI_PKEY_TooltipDescription | Można aktualizować tylko za pomocą unieważnienia. |
| UI_PKEY_TooltipTitle | Można aktualizować tylko za pomocą unieważnienia. |