Przełącz przycisk
Przycisk przełączania po kliknięciu udostępnia dane wejściowe aplikacji. Kontrolka reprezentuje wzajemnie wykluczające się stan przełącznika.
Szczegóły
Poniższy zrzut ekranu przedstawia przycisk przełączania wstążki.
Przełącz właściwości przycisku
Struktura wstążki definiuje kolekcję kluczy właściwości dla kontrolki Przycisk przełączania.
Zazwyczaj właściwość Przycisk przełączania 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ą Przełącz przycisk.
| 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. |