Compartir a través de


Botón de alternancia

El botón alternar cuando se hace clic en proporciona entrada a una aplicación. El control representa un estado de alternancia mutuamente excluyente.

Detalles

La siguiente captura de pantalla muestra el botón de alternancia de cinta de opciones.

captura de pantalla de un control togglebutton en la cinta de microsoft paint.

Alternar propiedades del botón

El marco de la cinta define una colección de claves de propiedad para el control Botón de alternancia.

Normalmente, se actualiza una propiedad Toggle Button en la interfaz de usuario de la cinta de opciones mediante la invalidación del comando asociado al control a través de una llamada a la método IUIFramework::InvalidateUICommand. El evento de invalidación se controla y las actualizaciones de propiedades definidas por el IUICommandHandler::UpdateProperty método de devolución de llamada.

El IUICommandHandler::UpdateProperty método de devolución de llamada no se ejecuta y la aplicación consultada para un valor de propiedad actualizado, hasta que el marco requiera la propiedad. Por ejemplo, cuando se activa una pestaña y se muestra un control en la interfaz de usuario de la cinta de opciones, o cuando se muestra una información sobre herramientas.

Nota

En algunos casos, se puede recuperar una propiedad a través del método IUIFramework::GetUICommandProperty y establecer con el método IUIFramework::SetUICommandProperty.

En la tabla siguiente se enumeran las claves de propiedad asociadas al control Botón de alternancia.

Clave de propiedad Notas
UI_PKEY_BooleanValue Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty. Nota: Si el comando asociado al control se invalida mediante una llamada a IUIFramework::InvalidateUICommand, el marco consulta esta propiedad cuando UI_INVALIDATIONS_VALUE se pasa como el valor de marcas.
UI_PKEY_Enabled Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Solo se puede actualizar a través de la invalidación.
UI_PKEY_Label Solo se puede actualizar a través de la invalidación.
UI_PKEY_LabelDescription Solo se puede actualizar a través de la invalidación.
UI_PKEY_LargeHighContrastImage Solo se puede actualizar a través de la invalidación.
UI_PKEY_LargeImage Solo se puede actualizar a través de la invalidación.
UI_PKEY_SmallHighContrastImage Solo se puede actualizar a través de la invalidación.
UI_PKEY_SmallImage Solo se puede actualizar a través de la invalidación.
UI_PKEY_TooltipDescription Solo se puede actualizar a través de la invalidación.
UI_PKEY_TooltipTitle Solo se puede actualizar a través de la invalidación.

biblioteca de controles de Windows Ribbon Framework

elemento de marcado ToggleButton