Botón Drop-Down
El botón de Drop-Down consta de un botón que cuando se hace clic muestra una lista desplegable de elementos mutuamente excluyentes.
- detalles
- propiedades del botón deDrop-Down
- temas relacionados
Detalles
Este control es útil para exponer elementos estrechamente relacionados en los casos en los que no hay ningún valor predeterminado obvio disponible y donde los elementos individuales se pueden representar mediante una imagen, texto o ambos.
En la captura de pantalla siguiente se muestra la cinta de opciones Drop-Down Botón en una cinta de ejemplo.
Propiedades del botón Drop-Down
El marco de la cinta define una colección de claves de propiedad para el control Botón de Drop-Down.
Normalmente, una propiedad button de Drop-Down se actualiza en la interfaz de usuario de la cinta de opciones invalidando el comando asociado con el 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 Drop-Down.
| Clave de propiedad | Notas |
|---|---|
| UI_PKEY_Categories | Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty. |
| 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 Button de Drop-Down 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 Drop-Down en la interfaz de usuario de la cinta de opciones. |
| UI_PKEY_ItemsSource | 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_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_SelectedItem | 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_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. |