Compartir a través de

SelectionTree Control

  • Artículo

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.

Propiedad Descripción
MsiSelectionTreeSelectedFeature Nombre de la característica seleccionada en el campo Característica de la tabla de características de .
MsiSelectionTreeSelectedAction Estado de la 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 se INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE o INSTALLSTATE_ADVERTISED.
MsiSelectionTreeSelectedCost Costo de instalar la característica seleccionada en unidades de 512 bytes.
MsiSelectionTreeChildrenCost Costo 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 instala como INSTALLSTATE_LOCAL.

 

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