Caption (Propiedad)

  • Artículo

Especifica el texto que se muestra en el título de un objeto. Está disponible en tiempo de diseño y en tiempo de ejecución.

Object.Caption[ = cText]

Valores de la propiedad

  • cText
    Especifica el texto que se muestra con un objeto.

Observaciones

Los títulos se muestran de forma diferente según el objeto:

  • Para los formularios, la propiedad Caption especifica el texto que se muestra en la barra de título del formulario. Cuando se minimiza el formulario, este texto aparece por debajo de su icono.
  • Para las páginas de un objeto PageFrame, la propiedad Caption especifica el texto que se muestra en la ficha de cada página.
  • Para los controles, la propiedad Caption especifica si el texto se muestra encima de un control o junto a él.
  • Para controles con la propiedad Style establecida como 1 (Gráfico) y para formularios que están minimizados, el título aparece bajo el icono.
  • Para documentos activos, la propiedad Caption determina el texto que se muestra en el elemento del menú de Ayuda del documento activo cuando se combina la Ayuda del documento activo con el menú Ayuda del contenedor. Al texto del elemento del menú de Ayuda del documento activo le sigue "Help". Por ejemplo, si la propiedad Caption se establece en "My Application", el elemento de menú Ayuda del documento activo se muestra como "My Application Help". El valor predeterminado de la propiedad Caption es "ActiveDoc1". Si la propiedad Caption se establece en una cadena vacía, se muestra "Microsoft Visual FoxPro" como elemento del menú de Ayuda.

Cuando crea un formulario o un control nuevo, su título predeterminado es igual que la configuración predeterminada de la propiedad Name. Este título predeterminado incluye la clase de objeto y un entero, como Command1, Combo1 o Form1.

La propiedad Name sirve para hacer referencia a un objeto en el código; la propiedad Caption es lo que aparece en la pantalla para identificar el control. Estas dos propiedades comienzan con el mismo valor, pero posteriormente se establecen de forma independiente.

Si no se ha especificado una configuración de la propiedad Width para el control, se ajustará automáticamente el tamaño del control para dar cabida al título.

Para objetos CommandGroup y OptionGroup, el título sólo se muestra si la propiedad BorderStyle está establecida como 1 (Sencilla fija).

Para un control Label, establezca la propiedad AutoSize en el valor verdadero (.T.) para cambiar automáticamente el tamaño del control y dar cabida a su título. El número máximo de caracteres para la propiedad Caption de un control Label es 256.

Para asignar una tecla de acceso a un control, incluya una barra inversa y un signo menor que (\<) en el título inmediatamente anterior al carácter que desea asignar como tecla de acceso. Un usuario puede presionar ALT y el carácter especificado para mover el enfoque al control. Si el control es un botón de comando, una casilla de verificación o un botón de opción, al presionar ALT y el carácter especificado también tendrá el mismo efecto que al hacer clic en el control.

Las teclas de acceso sólo están disponibles si se ha establecido KEYCOMP en WINDOWS. Si KEYCOMP está establecido en MAC (el valor predeterminado), las teclas de acceso no están disponibles y la letra de la tecla de acceso no está subrayada en el título.

Vea también

AutoSize (Propiedad) | BorderStyle (Propiedad) | Name (Propiedad) | Style (Propiedad) | Width (Propiedad)

Se aplica a: ActiveDoc (Objeto) | CheckBox (Control) | CommandButton (Control) | Form (Objeto) | Header (Objeto) | Label (Control) | OptionButton (Control) | Page (Objeto) | _SCREEN | ToolBar (Objeto)