Функция GetDlgItemText

Функция GetDlgItemText извлекает заголовок или текст, связанный с органом управления в диалоговом окне.

Синтаксис

UINT GetDlgItemText(
    HWND hDlg,
    int nIDDlgItem,
    LPTSTR lpString,
    int nMaxCount
);

Параметры

hDlg

[in] Дескриптор диалогового окна, которое содержит орган управления.

nIDDlgItem

[in] Устанавливает  идентификатор органа управления, заголовок или текст которого должен извлечься.

lpString

[out] Указатель на буфер, который получает заголовок или текст.

nMaxCount

[in] Устанавливает максимальную длину, в TCHARs (в символах), копируемой в буфер строки, на который указывает параметр  lpString. Если длина  строки  включает в себя символ  ПУСТО (NULL), нарушается ограничение  и символьная строка обрезается.

Возвращаемое значение

Если функция завершается успешно, возвращаемое значение устанавливает  число TCHARs (символов), скопированных  в буфер, не включая символ завершения строки ('0').

Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Если символьная строка очень длинная или она длиннее, чем буфер, то  буфер будет содержать обрезанную строку с символом завершения строки ('0').

Функция GetDlgItemText отправляет сообщение WM_GETTEXT органу управления.

Для  функции версии ANSI,  число TCHARs - число байтов; для версии Unicode, это - число символов.

Windows 95/98/Me: GetDlgItemTextW  поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Пример

Пример, см. в статье Создание модального диалогового окна.

Смотри также 

Обзор Диалоговые окнаФункции, используемые диалоговыми окнами, GetDlgItemIntSetDlgItemIntSetDlgItemTextWM_GETTEXT

Размещение и совместимость GetDlgItemText

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz