_TITLE

From QB64 Wiki
Revision as of 10:22, 5 March 2021 by Dkearns (talk | contribs) (Fix example highlighting/linking)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The _TITLE statement sets the program window's title-bar text.


Syntax

_TITLE text$


Parameters

  • text$ can be any literal or variable STRING value.


Description

  • The title bar will display "Untitled" if a title is not set with this statement.
  • The title of created $CONSOLE windows can be set using _CONSOLETITLE.
  • Note: A delay may be required before the title can be set. See _SCREENEXISTS.


Examples

Example 1: How to set the program window's title-bar text.

_TITLE "My New Program"


Example 2: How to find the currently running program module name and current path using a Windows API Library.

_TITLE "My program" _DELAY 5 '5 second delay _TITLE MID$(TITLE$, 1, INSTR(TITLE$, ".") - 1) PRINT PATH$ FUNCTION TITLE$ '=== SHOW CURRENT PROGRAM SHARED PATH$ DECLARE LIBRARY 'Directory Information using KERNEL32 provided by Dav FUNCTION GetModuleFileNameA (BYVAL Module AS LONG, FileName AS STRING, BYVAL nSize AS LONG) END DECLARE FileName$ = SPACE$(256) Result = GetModuleFileNameA(0, FileName$, LEN(FileName$)) IF Result THEN PATH$ = LEFT$(FileName$, Result) start = 1 DO posit = INSTR(start, PATH$, "\") IF posit THEN last = posit start = posit + 1 LOOP UNTIL posit = 0 TITLE$ = MID$(PATH$, last + 1) PATH$ = LEFT$(PATH$, last) ELSE TITLE$ = "": PATH$ = "" END IF END FUNCTION

Note: The actual module file name is returned. Not necessarily the Title value. The value returned can be used however.


See also



Navigation:
Keyword Reference - Alphabetical
Keyword Reference - By Usage
Main Wiki Page