Botón de expansión

  • Artículo

El botón dividir es un control compuesto con el que el usuario puede seleccionar un valor predeterminado enlazado a un botón principal, o seleccionar entre una lista de valores mutuamente excluyentes que se muestran en una lista desplegable enlazada a un botón secundario.

Introducción

Este control es útil para exponer elementos estrechamente relacionados en los casos en los que un valor predeterminado obvio está disponible y donde los elementos individuales se pueden representar mediante una imagen, texto o ambos.

En la captura de pantalla siguiente se muestra el botón de división de la cinta de opciones.

captura de pantalla de un control splitbutton en una cinta de opciones de ejemplo.

Propiedades del botón dividir

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

Normalmente, una propiedad Split Button se actualiza en la interfaz de usuario de la cinta invalidando el comando asociado al control a través de una llamada al método IUIFramework::InvalidateUICommand . El evento de invalidación se controla y la propiedad se actualiza definida por el método de devolución de llamada IUICommandHandler::UpdateProperty .

El método de devolución de llamada IUICommandHandler::UpdateProperty no se ejecuta y la aplicación consulta para obtener 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 Split Button.

Clave de propiedad Notas
UI_PKEY_Enabled Admite IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
Si todos los elementos secundarios están deshabilitados, el marco establece UI_PKEY_Enabled en false (0). De lo contrario, si uno o varios elementos secundarios están habilitados, UI_PKEY_Enabled se establece en true (-1). Importante:
La propiedad UI_PKEY_Enabled del control Split Button debe invalidarse después de que uno o varios elementos secundarios estén habilitados o deshabilitados. Esto garantiza que el marco consulta el valor de propiedad actualizado y actualiza el estado del control Split Button en la interfaz de usuario de la cinta de opciones.
UI_PKEY_Keytip 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 del marco de la cinta de opciones de Windows

Elemento de marcado SplitButton