Pole wyboru
Pole wyboru to kontrolka, która użytkownik może kliknąć, aby podać dane wejściowe aplikacji. Kontrolka zapewnia stan przełącznika reprezentowany wizualnie.
Szczegóły
Pole wyboru nie obsługuje stanu trzeciorzędnego ani nieokreślonego.
Poniższy zrzut ekranu przedstawia element Pole wyboru wstążki.
Właściwości pola wyboru
Struktura wstążki definiuje kolekcję kluczy właściwości dla kontrolki Pole wyboru.
Zazwyczaj właściwość Pole wyboru 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ą Pole wyboru.
| Klucz właściwości | Notatki |
|---|---|
| UI_PKEY_BooleanValue | 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_Enabled | 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_LabelDescription | 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_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. |