SelectionTree Control
Este control permite a un usuario cambiar el estado de selección de las características enumeradas en la tabla de características de . El control está asociado a una propiedad con valores de cadena que el usuario puede establecer mediante un cuadro de diálogo Examinar . Puede asociar el control a una propiedad escribiendo el nombre de la propiedad en la columna Propiedad de la tabla control de .
El control SelectionTree publica automáticamente los siguientes eventos de control en Windows XP o en sistemas operativos anteriores. El control SelectionTree publica estos eventos cuando el elemento seleccionado cambia de un nodo a otro. Si el árbol de selección no tiene nodos, el control publica estos eventos y borra el contenido de los controles que se suscriben al evento. No es necesario que estos ControlEvents aparezcan en la tabla controlEvent de .
Evento de control | Descripción |
---|---|
SelectionAction | Publica una cadena de la tabla uiText de que describe el elemento resaltado. |
SelectionBrowse | Genera un cuadro de diálogo Examinar usado para modificar la ruta de acceso del elemento resaltado. |
SelectionDescription | Publica una cadena de la tabla de características de que describe el elemento resaltado. |
SelectionNoItems | Elimina el texto descriptivo o deshabilita los botones de un elemento obsoleto. |
SelectionPath | Publica la ruta de acceso del elemento resaltado. |
SelectionPathOn | Publica si hay o no una ruta de selección asociada a la característica seleccionada actualmente. |
SelectionSize | Publica el tamaño del elemento resaltado. |
A partir de los sistemas Windows Server 2003, los controles SelectionTree publican todos los eventos de la tabla anterior y, además, publican un ControlEvent doActionEvent o un SetProperty ControlEvent. Los registros se deben agregar a la tabla controlEvent de para publicar DoAction o SetProperty ControlEvents.
Evento de control | Descripción |
---|---|
DoAction | Notifica al instalador que ejecute una acción personalizada. |
setProperty | Establece una propiedad en un nuevo valor. |
A partir de la versión 3.0 de Windows Installer, los controles SelectionTree publican un evento que ejecuta acciones personalizadas se muestran en la tabla ControlEvent. El control SelectionTree publica este evento cada vez que cambia la selección de características en el control o cada vez que se elige un estado de selección diferente para la característica actual. Las acciones personalizadas se ejecutan cada vez que se publica el evento. El control SelectionTree envía información a la acción personalizada estableciendo los valores de las siguientes propiedades. Todas estas propiedades se borran cuando se cierra el control SelectionTree.
Windows Installer 2.0: no se admite. El control SelectionTree no publica el evento y no establece las siguientes propiedades.
Nota
El control SelectionTree nunca muestra el contenido del campo Texto de la tabla Control. En su lugar, este campo especifica el estilo de texto que va a mostrar el control y contiene una descripción del control utilizado por las utilidades de revisión de pantalla. Para establecer el estilo de fuente y fuente de una cadena de texto, prefijo la cadena de caracteres mostrados con {\style} o {&estilo}. Donde style es un identificador que aparece en la columna TextStyle de la tabla TextStyle. Si ninguno de estos elementos está presente, pero la propiedad DefaultUIFont se define como un estilo de texto válido, se usa esa fuente. La información siguiente se lee mediante la revisión de pantalla de utilidades como descripción del control. Consulte accesibilidad.
Atributos de control
Puede usar los siguientes atributos con este control. Para cambiar el valor de un atributo mediante un evento, suscríbase el control a un ControlEvent en la tabla eventMapping de y enumere el identificador del atributo en la columna Atributo. Escriba el identificador de ControlEvent en la columna Evento.
Identificador de atributo | Bit hexadecimal | Descripción |
---|---|---|
IndirectPropertyName | Nombre de una propiedad indirecta asociada al control . Si se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Si se establece el bit de atributo indirecto, este nombre también es el valor de la propiedad que aparece en la columna Propiedad de la tabla control de . | |
posición | Posición del control en el cuadro de diálogo. Escriba el ancho, el alto y las coordenadas del control de la esquina izquierda del control en las columnas Width, Height, X e Y de la tabla control de . Use unidades del instalador para la longitud y la distancia. |
|
PropertyName de | Nombre de la propiedad asociada a este control. Si no se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Este atributo se especifica en la columna Propiedad de la tabla control de . | |
PropertyValue | Valor actual de la propiedad mostrada o modificada por este control. Si no se establece el bit de atributo indirecto, este es el valor de PropertyName. Si se establece el bit de atributo indirecto, este es el valor de IndirectPropertyName. Si el atributo cambia, el control refleja el nuevo valor. | |
text | Muestra texto en los lectores de pantalla según el texto escrito en la columna Texto de la tabla control de . Consulte accesibilidad. | |
visible | 0x00000000 0x00000001 |
Control oculto. Control visible. Incluya este bit en la palabra bit de la columna Atributos de la tabla control de para que el control sea visible o oculto tras su creación. También puede ocultar o mostrar un control mediante la tabla ControlCondition de . |
habilitado para | 0x00000000 0x00000002 |
Controlar en un estado deshabilitado. Controlar en un estado habilitado. Incluya este bit en la palabra bit de la columna Atributos del Control para habilitar el control sobre la creación. También puede habilitar o deshabilitar un control mediante la tabla controlCondition de . |
hundido | 0x00000000 0x00000004 |
Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D, hundido. Incluya estos bits en la palabra bit de la columna Atributos de la tabla control de . |
indirecto | 0x00000000 0x00000008 |
El control muestra o cambia el valor de la propiedad en la columna Propiedad de la tabla control de . El control muestra o cambia el valor de la propiedad que tiene el Identificador enumerado en la columna Propiedad de la tabla Control. Determina si la propiedad asociada a este control se hace referencia indirectamente. |
RTLRO de | 0x00000000 0x00000020 |
El texto del control se muestra en orden de lectura de izquierda a derecha. El texto del control se muestra en orden de lectura de derecha a izquierda. |
rightAligned | 0x00000000 0x00000040 |
El texto del control se alinea a la izquierda. El texto del control está alineado a la derecha. |
LeftScroll | 0x00000000 0x00000080 |
La barra de desplazamiento se encuentra en el lado derecho del control. La barra de desplazamiento se encuentra en el lado izquierdo del control. |
biDi | 0x000000E0 | Establezca este valor para una combinación de los atributos RTLRO, RightAlignedy LeftScroll. |
Observaciones
Este control se puede crear a partir de la clase WC_TREEVIEW mediante la funciónCreateWindowEx. Tiene los estilos WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOPy WS_GROUP.
El árbol de selección solo se rellena si se ha llamado a la acción acción CostInitialize y acción CostFinalize.
La siguiente cadena de la tabla UIText de está relacionada con este control.
Término | Descripción |
---|---|
AbsentPath |
Ruta de acceso que se muestra para un elemento en estado ausente. |
Las seis cadenas siguientes se usan para mostrar el número de elementos secundarios seleccionados y el tamaño asociado al elemento resaltado:
- SelChildCostPos
- SelChildCostNeg
- SelParentCostPosPos
- SelParentCostPosNeg
- SelParentCostNegPos
- SelParentCostNegNeg
Las cadenas siguientes se usan para mostrar las opciones de selección disponibles para un elemento en un menú emergente:
- MenuAbsent
- MenuLocal
- MenuCD
- MenuNetwork
- MenuAllLocal
- MenuAllCD
- MenuAllNetwork
Las cadenas siguientes se usan para explicar la selección actual en SelectionDescription ControlEvent.
- SelAbsentAbsent
- SelAbsentLocal
- SelAbsentCD
- SelAbsentNetwork
- SelLocalAbsent
- SelLocalLocal
- SelLocalCD
- SelLocalNetwork
- SelCDAbsent
- SelNetworkAbsent
- SelCDLocal
- SelNetworkLocal
- SelCDCD
- SelNetworkNetwork
Las cuatro cadenas localizadas siguientes se usan para dar formato al tamaño de un archivo:
- Bytes
- KB
- MB
- GB