rc = SysSetObjectData(<nombre>, <opciones>)
donde:
<nombre> es el objeto que desa cambiar (referido bien mediante la ruta completa o una ID de objeto, tal como <WP_DESKTOP>);
y <opciones> es una cadena de configuracin del WPS, que siempre tienen una sintaxis con la forma <clave>=<dato>. Se pueden combinar varias de estas opciones separndolas con punto y coma (";").
Ejemplo:
if SysSetObjectData(directory(),"NOMOVE=YES;DEFAULTVIEW=ICON") then
Say "Opciones cambiadas con xito"
Esto cambiar las opciones de carpeta para el directorio actual, lo que resulta til para scripts que llame XFolder, que presuponen que se ha ido al directorio sobre el que se quiere realizar el cambio.
Vea la informacin de REXX de OS/2 para ms detalles.
La siguiente lista describe todas las cadenas de configuracin de la clase WPObject, mas algunas cadenas adicionales soportadas por la clase WPFolder. (Brevemente, puede vd. utilizar cualquiera de estas cadenas en las carpetas). sta es la lista, ordenada alfabticamente:
ALWAYSSORT={YES|NO}
Indica si se mantiene siempre el orden de clasificacin de la carpeta. Si se mantiene el orden
de clasificacin, abrir la carpeta y añadirle un objeto puede llevar ms tiempo del normal.
Nota: XFolder ignora esta opcin si ha activado vd. las opciones avanzadas de clasificacin. Vea "Cadenas de configuracin de XFolder" para ms detalles sobre los cambios con respecto a esta opcin.
BACKGROUND=<nombre>,<modo>,<factor>,<tipofondo>,<color>
Esto indica las opciones del fondo de la carpeta, donde:
<nombre> = Nombre del archivo de imagen. Este debe ser un nombre con la ruta completa del archivo. No obstante, se permite "?:\" para indicar la unidad desde la que se ha arrancado.
<modo> = Modo de la imagen. Puede ser uno de los siguientes:
N = Imagen normal
T = En mosaico (Tiled)
S = Escala (Scaled)
<factor> = Factor de escala.
<tipofondo> = Tipo de fondo. Puede ser uno de los siguientes:
I = Imagen
C = Slo color
<color> = Color del fondo. Este color pueden ser tres nmeros representando valores RGB o el valor por omisin, en el siguiente formato: {R-valor G-valor B-valor}
Ejemplo: BACKGROUND=C:\OS2\BITMAP\OS2LOGO.BMP,S,3,I o BACKGROUND=(ninguno),,,C,0 128 128
CCVIEW=DEFAULT
Indica el valor por omisin en el sistema de la opcin "funcin Abrir objeto" cuando
se intenta abrir el objeto y ya est abierto (abrir vista concurrente). Puede encontrar este valor
por omisin en la pestaña "Ventana" de las propiedades de los objetos "Sistema" o "Workplace
Shell" de la carpeta "Configuracin del sistema". Puede ser uno de los siguientes:
CCVIEW=YES
Se crea una nueva vista del objeto cada vez que el usuario intenta abrirlo.
CCVIEW=NO
Mueve al primer plano las vistas abiertas del objeto cuando el usuario intenta abrirlo.
DEFAULTVIEW=DEFAULT
Establece la vista por omisin del objeto en lo que haya especificado en el
objeto "Sistema". ste es el valor por omisin.
DEFAULTVIEW={SETTINGS|ICON|TREE|DETAILS}
Establece la vista por omisin de la carpeta con el valor que se
especifique: Propiedades, Vista de iconos, de rbol o de detalles.
DETAILSCLASS=<classname>
Con esta opcin se especifica la clase de objeto para la que
se muestran los detalles en las vistas de detalles. La clase por omisin
es WPFileSystem. Mejor no juegue con esta opcin.
DETAILSFONT=<size>.<facename>
Cambia la fuente utilizada para la vista de detalles. Por ejemplo:
9.WarpSans Bold. El valor por omisin es 8.Helv
(en Warp 3)
DETAILSSHADOWCOLOR=<color> (slo Warp 4)
Color del texto de las sombras en Vista de detalles.
<color> puede ser un nombre
de color estndar o un conjunto de nmeros en formato R G B.
DETAILSTEXTCOLOR=<color> (slo Warp 4)
Color del texto de los objetos normales en Vista de detalles. <color>
puede ser un nombre estndar de color o un conjunto de nmeros R G B.
DETAILSVIEW=<style>
Establece el tamao de los iconos en Vista de detalles. Los posibles
valores son:
MINI iconos pequeos; ste es el valor por omisin.
NORMAL iconos de tamao normal.
HELPLIBRARY=<nombarch>
Especifica la biblioteca de ayuda.
HELPPANEL=<id>
Especifica el panel de ayuda por omisin dentro de la biblioteca de ayuda.
Mejor no juegue con estas opciones, puesto que debe conocer los identificadores
internos (ID) de los recursos de ayuda del WPS.
HIDEBUTTON={YES|NO}
Determina si la vista del objeto tiene un botn de minimizar o uno de
ocultar. Por omisin es la opcin especificada para las ventanas en el objeto
"Sistema", en la carpeta "Configuracin del sistema". Esta opcin no puede
especificarse aqu.
ICONFILE=<nombarch>
Especifica el icono de la carpeta cerrada. <nombarch>
debe un archivo ".ICO".
ICONFONT=<size>.<facename>
Se utiliza para cambiar la fuente utilizada para la Vista de iconos.
Por ejemplo: 10.Helv
ICONNFILE=<ndice>,<nombarch>
Establece el nombre del archivo del icono de animacin (carpeta abierta).
El valor <ndice> debe ser 1. El archivo especificado (".ICO")
contiene el icono de la carpeta abierta.
ICONNRESOURCE=<ndice>,<id>,<mdulo>
Establece el icono de animacin (carpeta abierta) desde un archivo de
recursos.
El valor <ndice>debe ser 1. El valor <id>
es el identificador del recurso con el icono en la biblioteca de enlace
dinmico (DLL) <mdulo>. El recurso especificado es el
icono de la carpeta abierta.
ICONPOS=<x>,<y>
Establece la posicin inicial del icono de la carpeta en la carpeta
padre. Los valores x e y representan la posicin en la carpeta en coordenadas
de porcentaje.
ICONRESOURCE=<id>,<mdulo>
Establece el icono del objeto a partir de datos en un archivo de recursos.
El valor <id> es el identificador (ID) del recurso con el
icono en la biblioteca de enlace dinmico (DLL) <mdulo>.
ICONSHADOWCOLOR=<color> (slo Warp 4)
Color del texto de las sombres en Vista de iconos.
<color> puede ser un nombre de color estndar o un
conjunto de nmeros r g b.
ICONTEXTBACKGROUNDCOLOR=<color> (slo Warp 4)
Color de fondo para el texto normal en Vista de iconos,
rbol o detalles.
<color> puede ser un nombre de color estndar o un
conjunto de nmeros r g b.
ICONTEXTCOLOR=<color> (slo Warp 4)
Color del texto para los iconos normales en Vista de iconos.
<color> puede ser un nombre de color estndar o un
conjunto de nmeros r g b.
ICONTEXTVISIBLE={YES|NO}
Los nombres de los iconos contenidos en la carpeta se muestran
o no en Vista de iconos.
ICONVIEW=<estilo1>[,<estilo2>...]
Establece los estilos especificados para la Vista de iconos. Los valores
posibles son: FLOWED NOGRID INVISIBLE NONFLOWED MINI NORMAL
El valor por omisin es NOGRID,NORMAL
Estos valores corresponden a la pgina "Vista de iconos" del cuaderno
de valores de una carpeta.
ICONVIEWPOS=<x>,<y>,<cx>,<cy>
Establece la posicin inicial del icono y el tamao de la carpeta en la
pantalla. Estos valores son porcentajes (0-100) del tamao de la pantalla.
LOCKEDINPLACE={YES|NO} (slo Warp 4)
Si el objeto est fijo o no en su posicin.
MENUBAR={YES|NO} (slo Warp 4)
Si se muestra o no la barra de men de la carpeta..
MENUITEMSELECTED <menu-id> (slo Warp 4)
Simula seleccionar el elemento de men especificado del man emergente del
objeto. <menu-id> debe ser un valor numrico.
Puede obtener <menu-id> para un elemento dado con la herramienta
XRAY, que est disponible en Internet. O mire en la pgina
"Identificadores de men del WPS".
(Eh, por cierto, esta opcin tambin funciona con los elementos de men que
aade XFolder.)
En realidad esto no es una "opcin", sino ms bien una accin
que se realiza sobre la carpeta.
MENUS={SHORT|LONG} (slo Warp 4)
Determina si el objeto tiene un men emergente corto (sin entradas
que dupliquen las acciones de las funciones de arrastrar y soltar) o el
completo.
MINWIN={HIDE|VIEWER|DESKTOP}
Determina si la carpeta minimizada ser ocultada, colocada en el
Visor de ventanas minimizadas, o minimizada en el escritorio.
El valor por omisin es el valor actual del botn Minimizar. Este
valor no puede especificarse aqu.
NOCOPY={YES|NO}
La carpeta no puede copiarse.
NODELETE={YES|NO}
No se puede borrar la carpeta. Tenga cuidado con esta.
NODRAG={YES|NO}
No se puede arrastrar la carpeta con el ratn.
NODROP={YES|NO}
La carpeta no aceptar que se arrastren objetos sobre ella.
NOLINK={YES|NO}
No se podrn crear sombras en esta carpeta.
NOMOVE={YES|NO}
La carpeta no puede moverse.
NOPRINT={YES|NO}
No se puede imprimir la carpeta. ste es el valor por omisin.
Por qu querra nadie imprimir una carpeta?
NORENAME={YES|NO}
No se puede renombrar la carpeta.
NOSETTINGS={YES|NO}
No se puede abrir el cuaderno de opciones de la carpeta.
NOSHADOW={YES|NO}
Lo mismo que NOLINK.
NOTVISIBLE={YES|NO}
La carpeta no es visible. Tenga cuidado con este estilo,
puede que no consiga recuperar la carpeta.
OBJECTID=<<name>>
Especifica un identificador (ID) permanente para el objeto.
Un identificador de objeto (ID) es una cadena nica que empieza con <
y termina con >.
Las ID de objeto son tiles para identificar objetos sin conocer su
localizacin exacta en el escritorio del usuario.
Por ejemplo, el escritorio siempre tiene la ID <WP_DESKTOP>
en todos los sistemas; a la carpeta de configuracin de XFolder se le asigna la
ID <XFOLDER_CONFIG>, de modo que XFolder puede encontrarla
incluso aunque la haya movido a otro lugar o le haya cambiado el nombre.
Consulte la pgina "Identificadores de objetos
del WPS" para ver un listado de las IDs del sistema.
Las ID de objeto son incluso necesarias para localizar objetos abstractos del WPS (p.e. sombras u objetos de programa) desde REXX, ya que estos objetos no pertenecen al sistema de archivos. De modo que si crea un objeto abstracto desde REXX y quiere poder abrirlo tambin desde REXX, debe asignarle una ID de objeto.
Por omisin, los objetos no tienen ID.
OPEN={SETTINGS|DEFAULT|ICON|TREE|DETAILS}
Abrir una vita del objeto ahora.
Este el inteligente truco utilizado por un zilln de programas REXX en
Internet para abrir una carpeta desde el indicador de mandatos de OS/2.
OPEN=DEFAULT abre al vista por omisin de la carpeta (como
si hubiera hecho doble clic sobre ella).
En realidad esto no es una "opcin", sino ms bien una accin
que se realiza sobre la carpeta. La carpeta se abrir inmediatamente.
REMOVEFONTS={YES|NO}
Elimina todas las fuentes definidas para la carpeta, es decir, las
que slo se aplican a esta carpeta (especificadas en las respectivas cadenas
de configuracin del objeto o en el cuaderno de propiedades de la carpeta).
El valor por omisin es NO.
En realidad esto no es una "opcin", sino ms bien una accin
que se realiza sobre la carpeta. La carpeta se abrir inmediatamente.
SHOWALLINTREEVIEW={YES|NO} (Slo Warp 4)
Mostrar todos los objetos en una Vista de rbol abierta, o slo las
carpetas.
SORTCLASS=<nombclas>
Define la clase de objeto por la que clasificar. El valor (clase) por
omisin es WPFileSystem.
TEMPLATE={YES|NO}
Determina si la carpeta es un modelo o no.
El valor por omisin es NO (por supuesto).
TITLE=<title>
Establece el ttulo del objeto en un nuevo valor. Esto cambia tambin
el nombre de archivo "real", igual que si se hubiera cambiado el ttulo desde
el WPS.
TREEFONT=<size>.<facename>
Cadena de configuracin utilizada para cambiar la fuente que se utiliza
para una Vista de rbol. Por ejemplo:: 10.Helv
TREESHADOWCOLOR=<color> (slo Warp 4)
Color del texto para los iconos de las sombras an Vista de rbol.
<color> puede ser un nombre
de color estndar o un conjunto de nmeros en formato R G B.
TREETEXTCOLOR=<color> (slo Warp 4)
Color del texto de los iconos normales en Vista de rbol.
<color> puede ser un nombre
de color estndar o un conjunto de nmeros en formato R G B.
TREETEXTVISIBLE={YES|NO} (slo Warp 4)
Si se muestran o no los nombres de los objetos en una Vista de rbol.
TREEVIEW=<estilo1>[,<estilo2>...]
Establece los estilos especificados para la vista de rbol. Los
valores posibles son: INVISIBLE LINES MINI NOLINES NORMAL
El valor por omisin es LINES, NORMAL
Estos valores corresponden a las opciones de la pgina "Vista de rbol"
del cuaderno de propiedades de la carpeta.
WORKAREA={YES|NO}
Establece que la carpeta es un rea de trabajo.
El valor por omisin es NO.