Függvény getwindowtext

[in] Kezel egy ablakot vagy vezérlő szöveget.

[ki] Jelzi azt a puffert, amely elfogadja a szöveget. A mutató a pufferhez, amely megkapja a szöveget. Ha a karakterlánc azonos hosszúságú vagy hosszabb, mint a puffer, akkor a csomópontot és a NULL karakterrel végződik.

Beállítja a karakterek maximális számát a pufferbe, beleértve a NULL karaktert is. Ha a szöveg túllépi ezt a határértéket, akkor a csonkolás megszakad.

Ha a függvény sikeres, akkor a visszatérési érték hossza, karakterekként, a másolt sorban, nem tartalmazza a végpont karaktert (null terminátor). Ha az ablaknak nincs címe vagy szövege, ha a fejléc egy üres karakterlánc, vagy ha az ablak vagy vezérlő fogantyúja érvénytelen, akkor a visszatérési érték nulla. A kiterjesztett hibaadatok eléréséhez hívja a GetLastError alkalmazást.

Ez a funkció nem tudja kivonni a szöveget a szerkesztési vezérlő mezőből egy másik alkalmazásprogramban.

Ha a célablak az aktuális téma birtokában van, akkor a GetWindowText funkció kényszerül küld egy WM_GETTEXT üzenetet a megadott ablakra vagy vezérlésre. Ha a célablak egy másik téma birtokában van, és rendelkezik egy GetWindowText fejléccel, akkor az ablak címszövegét lekéri. Ha az ablaknak nincs fejléce, akkor a visszatérési érték egy nulla karakterlánc. Ez a viselkedés a projektnek megfelelően szabályozott. Lehetővé teszi az alkalmazói programok számára a GetWindowText funkció hívását a program lebegése nélkül, ha a célablakot tulajdonló folyamat lefagy. Ha azonban a célablak lefedi és a hívó programhoz tartozik, akkor a GetWindowText funkció a hívó program lefagyását eredményezi.

Ha egy másik folyamatban a szövegből kivonni szeretné a szöveget, küldje el közvetlenül a WM_GETTEXT üzenetet a GetWindowText hívása helyett.

Kapcsolódó cikkek