);
Параметры
lpClassName - указывает на завершающуюся нулем строку, определяющую имя класса или атом, идентифицирующий строку имени класса. Если этот параметр является атомом, то он должен быть глобальным атомом, созданным предыдущим вызовом функции GlobalAddAtom . 16-ти битное значение атома должно быть размещено в младшем слове lpClassName , старшее слово должно быть равно нулю.
lpWindowName - указывает на завершающуюся нулем строку, определяющую имя окна (заголовок окна). Если значение этого параметра равно NULL, то со значением lpWindowName совпадают имена всех окон.
Возвращаемые значения
В случае успеха функция возвращает дескриптор окна, которое имеет указанные имя класса и имя окна. В случае неудачи возвращается NULL. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См . также
EnumWindows, FindWindowEx, GetClassName, GlobalAddAtom .
FindWindowEx
Функция FindWindowEx извлекает дескриптор окна, чье имя класса и имя окна совпадают с указанными строками. Функция также просматривает дочерние окна, начиная с того, дескриптор которого передан функции в качестве параметра hwndChildAfter .
HWND FindWindowEx (
HWND hwndParent , // дескриптор родительского окна
HWND hwndChildAfter , // дескриптор дочернего окна
LPCTSTR lpszClass , // указатель на имя класса
LPCTSTR lpszWindow // указатель на имя окна
);
Параметры
hwndParent - идентифицирует родительское окно, среди дочерних окон которого будет проводиться поиск.
Если значение параметра hwndParent равно NULL, функция использует рабочий стол Windows в качестве родительского окна. Функция проводит поиск среди окон, являющимися дочерними окнами рабочего стола.
hwndChildAfter - идентифицирует дочернее окно. Поиск начинается со следующего окна в Z- последовательности. Окно, указанное параметром hwndChildAfter , должно быть прямым дочерним окном указанного параметром hwndParent окна, а не порожденным окном.
Если значение параметра hwndChildAfter равно NULL, поиск начинается с первого дочернего окна.
Примечание: Если значения обоих параметров hwndParent и hwndChildAfter равны NULL, функция проводит поиск среди всех окон верхнего уровня.
lpszClass - указывает на завершающуюся нулем строку, определяющую имя класса или атом, идентифицирующий строку - имя класса. Если этот параметр является атомом, он должен быть глобальным атомом, созданным предыдущим вызовом функции GlobalAddAtom . Значение атома должно быть помещено в младшее слово lpszClass , старшее слово должно быть равно нулю.
lpszWindow - указывает на завершающуюся нулем строку, определяющую имя окна (заголовок окна). Если значение этого параметра равно NULL, то совпадающими со строкой считаются все имена окон.
Возвращаемые значения
В случае успеха возвращается дескриптор окна, которое имеет заданные имя класса и имя окна.
В случае неудачи возвращается NULL. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См. также
EnumWindows, FindWindow, GetClassName, GlobalAddAtom .
GetClientRect
Функция GetClientRect возвращает координаты клиентской области окна. Клиентские координаты определяют верхний левый и правый нижний углы клиентской области. Поскольку клиентские координаты относительны левого угла клиентской области окна, то координатой верхнего левого угла является (0, 0).
BOOL GetClientRect (
HWND hWnd // дескриптор окна
LPRECT lpRect // адрес структуры для клиентских координат
);
Параметры
hWnd - идентифицирует окно, клиентские координаты которого возвращаются.
lpRect - указывает на структуру, получающую клиентские координаты. Члены left и top равны нулю. Члены right и bottom содержат ширину и высоту окна.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См . также
GetWindowRect, RECT.
SetWindowText
Функция SetWindowText изменяет текст заголовка (если заголовок существует) указанного окна. Если указанное окно является элементом управления, то изменяется текст этого элемента управления.
BOOL SetWindowText (
HWND hWnd , // дескриптор окна или элемента управления
LPCTSTR lpString // адрес строки
);
Параметры
hWnd - идентифицирует окно или элемент управления, чей текст изменяется.
lpString - указывает на завершающуюся нулем строку, используемую в качестве нового заголовка окна или текста элемента управления.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке, вызовите функцию GetLastError
Комментарии
Функция SetWindowText отправляет сообщение WM_SETTEXT указанному окну или элементу управления. Тем не менее, если окно является окном списка, созданным с параметром WS_CAPTION, SetWindowText устанавливает текст для элемента управления, а не для элементов списка.
Функция SetWindowText не разворачивает символы табуляции ( ASCII -код 0 x 09). Символы табуляции отображаются как вертикальная черта (|).
См . также
GetWindowText , WM_SETTEXT.
Каретка
CreateCaret
Функция CreateCaret создает новый внешний вид для системной каретки и присваивает владение кареткой указанному окну. Каретка может быть прямоугольником, линией или битовым образом.
BOOL CreateCaret (
HWND hWnd , // дескриптор окна-владельца
HBITMAP hBitmap , // дескриптор битового образа для каретки
int nWidth , // ширина каретки