Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 bien seleccionar de una lista de valores mutuamente excluyentes mostrados en una lista desplegable enlazada a un botón secundario.
Introducción
Este control es útil para exponer elementos estrechamente relacionados en casos en los que un valor predeterminado obvio está disponible y donde los elementos individuales se pueden representar mediante una imagen, texto o ambos.
La siguiente captura de pantalla muestra el botón de división de la cinta de opciones.
Propiedades del botón dividir
El marco de la cinta define una colección de claves de propiedad para el control Botón de división.
Normalmente, se actualiza una propiedad Split Button en la interfaz de usuario de la cinta de opciones 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 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 división.
| Clave de propiedad | Notas |
|---|---|
| UI_PKEY_Enabled | Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty. Si todos los elementos secundarios están deshabilitados, el marco establece UI_PKEY_Enabled en false (0). De lo contrario, si se habilitan uno o varios elementos secundarios, UI_PKEY_Enabled se establece en true (-1). importante: La propiedad UI_PKEY_Enabled del control Botón de división debe invalidarse después de habilitar o deshabilitar uno o varios elementos secundarios. Esto garantiza que el marco consulta el valor de propiedad actualizado y actualiza el estado del control Botón de división 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. |