LocateChildWindow

📝 Description

Find subordinate windows (child windows) in an application! LocateChildWindow locates dialogs, panels, embedded windows, and controls - no more hidden windows blocking your workflow!

With support for window classes, control IDs, and hierarchical search, you navigate complex UI structures - the key component for advanced UI automation!

🚀 Why This Tool Stands Out

• 🔍Find Child Windows in the hierarchy
• 🎛️Locate Controls by class
• 📋Identify dialogs & panels
• 🎯Handle for direct interaction

📊 JSON Parameters

• parentHandle REQUIRED (Integer)The window handle (HWND) of the parent window. Can be obtained via LocateAppWindow.
• className OPTIONAL (String)The Windows class of the child window (e.g., "Button", "Edit", "#32770" for dialogs)
• windowTitle OPTIONAL (String)Title or part of the title of the child window
• controlId OPTIONAL (Integer)The control ID of the element (for dialog controls)
• index OPTIONAL (Integer)Index if multiple matching child windows exist (0-based). Default: 0

💡 Example Call

{
  "tool": "LocateChildWindow",
  "params": {
    "parentHandle": 123456,
    "className": "Button",
    "windowTitle": "OK"
  }
}

💻 Example Usage

🔄 Return Values

The tool returns an object with the following properties:

• success (Boolean)
  True if a child window was found
• found (Boolean)
  Whether a matching child window exists
• windowHandle (Integer)
  Window handle (HWND) of the child window found
• className (String)
  Windows class of the element found
• windowTitle (String)
  Title of the child window found
• controlId (Integer)
  Control ID of the element
• x (Integer)
  X position relative to the parent
• y (Integer)
  Y position relative to the parent
• error (String, optional)
  Error message if the search failed

🔗 Related Tools

• LocateAppWindowFind application windows
• LocateGUIElementLocate GUI elements
• GetWindowStateCheck window state
• SetWindowStateChange window state