IpString - указатель на буфер, содержащий выбранную строку списка.

nIDListBox - ID окна списка, расположенного в данном диалоговом окне.

Метод DlgDirSelect посылает окну списка сообщения LB_GETCURSEL и LB_GETTEXT.

Этот метод не используется только для списков с множественным выбором (multiple-selection list box).

BOOL DlgDirSelectComboBox (LPTSTR ipString, int nIDComboBox);

Метод определяет строку, соответствующую выбранному элементу комбинированного окна списка (предполагается, что список был заполнен методом DlgDirlistComboBox). При успешном завершении метод возвращает ненулевое значение.

Метод DlgDirSelectComboBox посылает комбинированному окну списка сообщения CB_GETCURSEL и CB_GETLBTEXT.

UINT GetDlgltemlnt (int nID, BOOL* ipTrans = NULL, BOOL bSigned = TRUE) const;

Метод определяет значение, соответствующее тексту элемента управления, расположенного в диалоговом окне.

Метод посылает элементу управления сообщение WM_GETTEXT. int GetDlgltemText (int nID, LPTSTR ipStr, int tiMaxCount) const; int GetDlgltemText (int nID, CString& rString) const;

Эти методы возвращают количество байт текста элемента управления, скопированных в буфер. Если в буфер не было записано никакого текста, то метод возвращает значение 0.

Параметры:

nID - идентификатор элемента управления.

IpStr - указатель на буфер, в который заносится текст или заголовок элемента управления.

nMaxCount - максимальное число символов, копируемых в буфер IpStr. rString - ссылка на строку CString.

CWnd* GetNextDlgGroupItem (CWnd* pWndCtl, BOOL bPrevious = FALSE) const;

При успешном завершении метод возвращает указатель на следующий или предыдущий элемент управления группы элементов управления диалогового окна.

Параметры:

pWndCtl - указывает элемент управления, используемый в качестве начальной точки поиска.

bPrevious - определяет направление поиска: при значении TRUE метод выполняет поиск предыдущего элемента управления, а при значении FALSE -следующего.

Напомним, что начало группы элементов управления определяется первым элементом управления, созданным со стилем WS_GROUP, а последним элементом управления группы считается элемент управления, созданный перед последующим элементом управления, созданным опять со стилем WS_GROUP.

CWnd* GetNextDlgTabltem (CWnd* pWndCtl, BOOL bPrevious = FALSE) const;

При успешном выполнении метод возвращает указатель на следующий или предыдущий элемент управления, имеющий стиль WS_TABSTOP. UINT IsDlgButtonChecked (int nIDButton) const;

Метод возвращает ненулевое значение в том случае, если указанный элемент управления отмечен. Отмеченными (включенными) могут быть только флажки или радиокнопки. Для командных кнопок данный метод возвращает значение 0.

Параметры:

nIDButton - идентификатор элемента управления кнопка. BOOL IsDialogMessage (LPMSG ipMsg);

Метод определяет, предназначено ли указанное сообщение для модельного диалогового окна, и если да, то выполняет обработку этого сообщения. Если сообщение было обработано, то метод возвращает ненулевое значение.

Параметры: IpMsg - указатель на структуру MSG, содержащую сообщение.

При обработке сообщения метод IsDialogMessage использует сообщение от клавиатуры, например нажатие клавиши TAB - для перехода к следующему элементу управления или группе, а нажатие клавиши DOWN ARROW -для перехода к следующему элементу в группе.

Если метод возвращает нулевое значение, то для обработки сообщения можно вызвать метод CWnd::PreTranslateMessage.

Приведем пример переопределения метода PreTranslateMessage:

BOOL CMyDlg::PreTranslateMessage (msg)

{ if (IsDialogMessage (msg)) // Попытка обработки сообщения

// модальным диалоговым окном

return TRUE;

else

return CWnd::PreTranslateMessage (msg); // Вызов метода базового класса

}

LRESULT SendDlgltemMessage (int nID, UINT message, WPARAM wParam = 0, LPARAM iParam = 0);

Метод посылает сообщение указанному элементу управления.

Этот метод аналогичен методу SendMessage, вызванному с указателем CWnd* на данный элемент управления.

void SetDIgltemlnt (int nID, UINT nValue, BOOL bSigned = TRUE);

Метод устанавливает для указанного элемента управления текст, представленный числовым значением.

Параметры:

nID - ID изменяемого элемента управления.

nValue - числовое значение, используемое для генерации текста.

bSigned - флажок, определяющий, является ли значение знаковым или беззнаковым. Если этот параметр равен TRUE, a nValue меньше чем 0, то перед первой цифрой формируемой строки будет расположен знак минус.

Этот метод посылает указанному элементу управления сообщение WM_SETTEXT.

void SetDlgltemText (int nID, LPCTSTR ipszString); Метод устанавливает заголовок или текст элемента управления.

Этот метод посылает указанному элементу управления сообщение WMJSETTEXT.

BOOL ExecuteDIglnit (LPCTSTR ipszResourceName); BOOL ExecuteDIglnit (LPVOID ipResource);

Метод позволяет инициировать ресурс диалога.