Freigeben über

Caption-Eigenschaft

  • Artikel

Gibt den Text an, der als Beschriftung eines Objekts angezeigt wird. Diese Eigenschaft ist zur Entwurfs- und Laufzeit verfügbar.

Object.Caption[ = cText]

Eigenschaftswerte

  • cText
    Gibt den Text an, der zusammen mit einem Objekt angezeigt wird.

Hinweise

Beschriftungen werden je nach Objekt unterschiedlich angezeigt:

  • Bei Formularen gibt die Caption-Eigenschaft den Text an, der in der Titelleiste des Formulars angezeigt wird. Wenn Sie das Formular minimieren (zum Symbol verkleinern), wird dieser Text unterhalb des Formularsymbols angezeigt.
  • Bei Seiten eines Seitenrahmen-Objekts (PageFrame) gibt die Caption-Eigenschaft den Text an, der auf dem Register jeder Seite angezeigt wird.
  • Bei Steuerelementen gibt die Caption-Eigenschaft den Text an, der auf oder neben dem Steuerelement angezeigt wird.
  • Bei Steuerelementen, für die die Style-Eigenschaft auf den Wert 1 (grafisch) festgelegt ist sowie bei Formularen, die minimiert (als Symbol) angezeigt werden, wird die Beschriftung unter dem Symbol angezeigt.
  • Für aktive Dokumente (Active Documents) bestimmt die Caption-Eigenschaft den Text, der im Hilfemenü-Element des aktiven Dokuments angezeigt wird, wenn das Hilfemenü dieses Dokuments mit dem Hilfemenü seines Containers zusammengeführt wird. Hinter dem Text auf dem Hilfemenü-Element des aktiven Dokuments steht "Hilfe". Wenn z. B. die Caption-Eigenschaft auf "Meine Anwendung " festgelegt ist, zeigt das Hilfemenü-Element des aktiven Dokuments "Meine Anwendung Hilfe" an. Der Standardwert der Caption-Eigenschaft ist ActiveDoc1. Ist die Caption-Eigenschaft auf die leere Zeichenfolge festgelegt, wird "Microsoft Visual FoxPro" als Hilfemenü-Element angezeigt.

Wird ein neues Formular oder Steuerelement erstellt, ist die Standardbeschriftung mit der Standardeinstellung der Name-Eigenschaft identisch. Diese Standardbeschriftung besteht aus der Objektklasse und einer ganzen Zahl, wie z. B. Command1, Combo1 oder Form1.

Über die Name-Eigenschaft verweisen Sie auf ein Objekt im Code, während die Caption-Eigenschaft den Text angibt, der zur Identifizierung des Steuerelements auf dem Bildschirm angezeigt wird. Diese zwei Eigenschaften weisen anfangs identische Werte auf, werden aber später unabhängig voneinander festgelegt.

Wird für das Steuerelement die Width-Eigenschaft nicht eingestellt, erfolgt eine automatische Anpassung der Größe des Steuerelements an die Beschriftung.

Bei Schaltflächengruppen- (CommandGroup) und Optionsgruppen-Objekten (OptionGroup) wird die Beschriftung nur angezeigt, wenn die BorderStyle-Eigenschaft auf 1 – Fixed Single festgelegt ist.

Legen Sie bei einem Bezeichnungs-Steuerelement (Label) die AutoSize-Eigenschaft auf Wahr (.T.) fest, wenn die Größe des Steuerelements automatisch an die Beschriftung angepasst werden soll. Die maximale Anzahl von Zeichen für die Caption-Eigenschaft eines Bezeichnungs-Steuerelements (Label) ist 256.

Um einem Steuerelement eine Zugriffstaste zuzuweisen, stellen Sie in der Beschriftung direkt vor das Zeichen, das Sie als Zugriffstaste verwenden möchten, einen umgekehrten Schrägstrich und ein Kleiner-als-Zeichen (\<). Der Benutzer kann jetzt den Fokus auf dieses Steuerelement bewegen, indem er ALT und das angegebene (unterstrichene) Zeichen drückt. Handelt es sich bei dem Steuerelement um eine Befehlsschaltfläche oder ein Optionsfeld, hat das Drücken von ALT und dem angegebenen (unterstrichenen) Zeichen denselben Effekt wie das Klicken auf das Steuerelement.

Zugriffstasten sind nur dann verfügbar, wenn KEYCOMP auf WINDOWS festgelegt wurde. Ist KEYCOMP auf MAC (Standardwert) festgelegt, sind keine Zugriffstasten verfügbar und der entsprechende Buchstabe in der Beschriftung ist nicht unterstrichen.

Siehe auch

AutoSize-Eigenschaft | BorderStyle-Eigenschaft | Name-Eigenschaft | Style-Eigenschaft | Width-Eigenschaft

Betrifft: ActiveDoc-Objekt | CheckBox-Steuerelement | Befehlsschaltfläche-Steuerelement (CommandButton) | Formularobjekt (Form) | Header-Objekt | Bezeichnungs-Steuerelement | Optionsfeld-Steuerelement (OptionButton) | Seitenobjekt (Page) | _SCREEN-Systemvariable | Symbolleisten-Objekt