Difference between revisions of "Lua:getWindowCaption"
Jump to navigation
Jump to search
(Created page with "<p><b>getWindowCaption(windowhandle)</b> : string - Returns the caption of the window</p> <p></p> <pre> local hwnd = findWindow("WTWindow", "Game") print( getWindowCaption(hwn...") |
(Major overhaul of the post.) |
||
| Line 1: | Line 1: | ||
| − | + | [[Category:Lua]] | |
| − | + | {{CodeBox|'''function''' getWindowCaption(''windowhandle'') ''':''' string}} | |
| + | |||
| + | Returns the caption text of a window. | ||
| + | |||
| + | The window is identified by its window handle. | ||
| + | |||
| + | ===Function Parameters=== | ||
| + | {|width="85%" cellpadding="10%" cellspacing="0" border="0" | ||
| + | !align="left"|Parameter | ||
| + | !align="left"|Type | ||
| + | !style="width: 80%;background-color:white;" align="left"|Description | ||
| + | |- | ||
| + | |windowhandle | ||
| + | |Integer | ||
| + | |The handle of the window whose caption should be returned. | ||
| + | |} | ||
| + | |||
| + | ===Returns=== | ||
| + | String — The caption text of the specified window. | ||
| + | |||
| + | ===Examples=== | ||
<pre> | <pre> | ||
| − | local | + | local form = createForm() |
| − | print( | + | form.Caption = "Example Window" |
| + | |||
| + | local caption = getWindowCaption(form.Handle) | ||
| + | |||
| + | print(caption) | ||
</pre> | </pre> | ||
| + | |||
| + | <pre> | ||
| + | local mainForm = getMainForm() | ||
| + | |||
| + | if mainForm ~= nil then | ||
| + | local caption = getWindowCaption(mainForm.Handle) | ||
| + | print("Main form caption: " .. tostring(caption)) | ||
| + | end | ||
| + | </pre> | ||
| + | |||
| + | <pre> | ||
| + | local memoryView = getMemoryViewForm() | ||
| + | |||
| + | if memoryView ~= nil then | ||
| + | print(getWindowCaption(memoryView.Handle)) | ||
| + | end | ||
| + | </pre> | ||
| + | |||
| + | ===Notes=== | ||
| + | * The function requires a valid window handle. | ||
| + | * For Cheat Engine controls and forms, the Handle property can usually be used. | ||
| + | * For normal Cheat Engine form objects, reading the Caption property directly is usually simpler. | ||
| + | |||
| + | {{LuaSeeAlso}} | ||
| + | |||
| + | {{Forms}} | ||
Revision as of 00:44, 25 June 2026
Returns the caption text of a window.
The window is identified by its window handle.
Contents
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| windowhandle | Integer | The handle of the window whose caption should be returned. |
Returns
String — The caption text of the specified window.
Examples
local form = createForm() form.Caption = "Example Window" local caption = getWindowCaption(form.Handle) print(caption)
local mainForm = getMainForm()
if mainForm ~= nil then
local caption = getWindowCaption(mainForm.Handle)
print("Main form caption: " .. tostring(caption))
end
local memoryView = getMemoryViewForm() if memoryView ~= nil then print(getWindowCaption(memoryView.Handle)) end
Notes
- The function requires a valid window handle.
- For Cheat Engine controls and forms, the Handle property can usually be used.
- For normal Cheat Engine form objects, reading the Caption property directly is usually simpler.
