Compartir a través de


Control SelectionTree

Este control permite al usuario cambiar el estado de selección de las características enumeradas en la tabla Feature. 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 este control a una propiedad si escribe el nombre de la propiedad en la columna Propiedad de la tabla Control.

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.

Evento de control Descripción
SelectionAction Publica una cadena de la tabla UIText que describe el elemento resaltado.
SelectionBrowse Genera un cuadro de diálogo Examinar que se usa para modificar la ruta de acceso del elemento resaltado.
SelectionDescription Publica una cadena de la tabla Feature 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 de Windows Server 2003, los controles SelectionTree publican todos los eventos de la tabla anterior y, además, publican un ControlEvent de DoAction o un ControlEvent de SetProperty. Los registros se deben agregar a la tabla ControlEvent para publicar ControlEvents de DoAction o SetProperty.

Evento de control Descripción
DoAction Notifica al instalador que ejecute una acción personalizada.
SetProperty Establece una propiedad en un valor nuevo.

 

A partir de la versión 3.0 de Windows Installer, los controles de SelectionTree publican un evento que ejecuta acciones personalizadas enumeradas en la tabla ControlEvent. El control SelectionTree publica este evento cada vez que la selección de características cambia 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.

Propiedad Descripción
MsiSelectionTreeSelectedFeature El nombre de la característica seleccionada en el campo Feature de la tabla Feature.
MsiSelectionTreeSelectedAction Estado de acción de instalación de la característica seleccionada. El valor puede ser INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE o INSTALLSTATE_ADVERTISED.
MsiSelectonTreeChildrenCount Número de nodos secundarios directos.
MsiSelectionTreeInstallingChildrenCount Número de nodos secundarios directos que sean INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE o INSTALLSTATE_ADVERTISED.
MsiSelectionTreeSelectedCost Coste de instalar la característica seleccionada en unidades de 512 bytes.
MsiSelectionTreeChildrenCost Coste de instalar todas las características secundarias en unidades de 512 bytes.
MsiSelectionTreeSelectedPath Ruta de acceso en la que se está instalando la característica seleccionada. Se define solo si la característica se está instalando como INSTALLSTATE_LOCAL.

 

Nota:

El control SelectionTree nunca muestra el contenido del campo Text 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 herramientas de lectura de pantalla. Para establecer la fuente y el estilo de fuente de una cadena de texto, anteponga la cadena de caracteres mostrados con {\style} o {&style}. 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 siguiente información se lee mediante las herramientas de lectura de pantalla como la descripción del control. Consulte Accesibilidad.

 

Atributos de control

Puede usar los atributos siguientes con este control. Para cambiar el valor de un atributo mediante un evento, suscriba el control a un ControlEvent en la tabla EventMapping y enumere el identificador del atributo en la columna Attribute. Escriba el identificador de ControlEvent en la columna Event.

Identificador de atributo Bit hexadecimal Descripción
IndirectPropertyName Nombre de una propiedad indirecta asociada al control. Si se establece el bit de atributo Indirect, 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 Property de la tabla Control.
Posición Posición del control en el cuadro de diálogo. Especifique 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. Use unidades del instalador para la longitud y la distancia.
PropertyName Nombre de la propiedad asociada al control. Si no se establece el bit de atributo Indirect, el control muestra o cambia el valor de la propiedad que tiene este nombre. Este atributo se especifica en la columna Property de la tabla Control.
PropertyValue Valor actual de la propiedad mostrada o modificada por este control. Si no se establece el bit de atributo Indirect, este es el valor de PropertyName. Si se establece el bit de atributo Indirect, este es el valor de IndirectPropertyName. Si el atributo cambia, el control refleja el nuevo valor.
Texto Muestra texto en los lectores de pantalla según el texto escrito en la columna Text de la tabla Control. Consulte Accesibilidad.
Visible 0x00000000 0x00000001
Control oculto. Control visible.
Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para que el control esté visible u oculto al crearlo.
Un control se puede ocultar o mostrar también mediante la tabla ControlCondition.
Enabled 0x00000000 0x00000002
Control en estado deshabilitado. Control con el estado habilitado.
Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para habilitar el control al crearlo.
También se puede habilitar o deshabilitar un control mediante la tabla ControlCondition.
Sunken 0x00000000 0x00000004
Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D, con profundidad.
Incluya estos bits en la palabra bit de la columna Attributes de la tabla Control.
Indirecto 0x00000000 0x00000008
El control muestra o cambia el valor de la propiedad en la columna Property de la tabla Control. El control muestra o cambia el valor de la propiedad que tiene el Identificador que aparece en la columna Property de la tabla Control.
Determina si se hace referencia indirectamente a la propiedad asociada a este control.
RTLRO 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 está alineado a la izquierda. El texto del control está alineado a la derecha.
LeftScroll 0x00000000 0x00000080
La barra de desplazamiento se encuentra a la derecha del control. La barra de desplazamiento se encuentra a la izquierda del control.
BiDi 0x000000E0 Establezca este valor para una combinación de los atributos RTLRO, RightAligned y LeftScroll.

 

Observaciones

Este control se puede crear a partir de la clase WC_TREEVIEW mediante la función CreateWindowEx. Tiene los estilos WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOP y WS_GROUP.

El árbol de selección solo se rellena si se ha llamado a la acción CostInitialize y a la acción CostFinalize.

La siguiente cadena de la tabla UIText está relacionada con este control.

Término Descripción
AbsentPath
Ruta de acceso mostrada 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 siguientes cadenas 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 siguientes cadenas se usan para explicar la selección actual en el ControlEvent SelectionDescription.

  • SelAbsentAbsent
  • SelAbsentLocal
  • SelAbsentCD
  • SelAbsentNetwork
  • SelLocalAbsent
  • SelLocalLocal
  • SelLocalCD
  • SelLocalNetwork
  • SelCDAbsent
  • SelNetworkAbsent
  • SelCDLocal
  • SelNetworkLocal
  • SelCDCD
  • SelNetworkNetwork

Estas cuatro cadenas localizadas se usan para dar formato al tamaño de un archivo:

  • Bytes
  • KB
  • MB
  • GB