Тарас Сорока - Русский справочник по Win32 API

• Название: Русский справочник по Win32 API
• Автор: Тарас Сорока
• Жанр: Программирование

---

MF_MENUBARBREAK

То же, что и флаг MF _ MENUBREAK, за исключением выпадающих меню, меню быстрого вызова команд и подменю, где новый столбец от старого столбца отделяется вертикальной чертой.

MF_MENUBREAK

Помещает новый пункт в новой строке (для строк меню) или в новый столбец (для выпадающих меню, меню быстрого вызова команд и подменю) без разделения столбцов.

MF_SEPARATOR

Создает горизонтальную разделяющую линию (для выпадающих меню, меню быстрого вызова команд и подменю).

См. также

GetMenu, GetMenuItemCount, GetMenuItemID, GetMenuItemInfo, GetMenuString .

SetMenuItemBitmaps

Функция SetMenuItemBitmaps связывает указанный битовый образ с пунктом меню. В зависимости от того, является ли пункт меню отмеченным или нет, Windows отображает соответствующий битовый образ в пункте меню.

BOOL SetMenuItemBitmaps (

HMENU hMenu , // дескриптор меню

UINT uPosition , // пункт меню для получения нового битового образа

UINT uFlags , // флаги пункта меню

HBITMAP hBitmapUnchecked , // дескриптор битового образа

// для неотмеченного состояния

HBITMAP hBitmapChecked // дескриптор битового образа

// для отмеченного состояния

);

Параметры

hMenu - идентифицирует меню, содержащее элемент, который получает новые битовые образы отмеченного и неотмеченного состояний.

uPosition - определяет подлежащий изменению пункт меню в соответствии со значением параметра uFlags .

uFlags - определяет, как интерпретируется значение параметра uPosition . Параметр uFlags должен быть одним из следующих значений:

Значение

Пояснение

MF _ BYCOMMAND

Указывает, что значение uPosition представляет собой идентификатор пункта меню. Если не задан ни один из флагов, то используется флаг по умолчанию - MF _ BYCOMMAND .

MF _ BYPOSITION

Указывает, что значение uPosition представляет собой относительную позицию пункта меню (отсчет позиции начинается с нуля).

hBitmapUnchecked - идентифицирует битовый образ, отображаемый, когда пункт меню не отмечен.

hBitmapChecked - идентифицирует битовый образ, отображаемый, когда пункт меню отмечен.

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

В случае успеха возвращается ненулевое значение.

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

Комментарии

Если значение параметра hBitmapUnchecked или hBitmapChecked равно NULL, Windows ничего не отображает в соответствующем пункте меню для соответствующего состояния. Если значения обоих параметров равны NULL, то Windows отображает стандартный битовый образ отметки, соответствующей отмеченному состоянию, и убирает битовый образ, когда пункт меню не отмечен.

При разрушении меню эти битовые образы не разрушаются: их должно разрушить приложение.

Windows NT : Функция GetMenuCheckMarkDimensions извлекает размеры отметки по умолчанию, используемой для пунктов меню. Эти значения используются для определения соответствующих размеров битовых образов, используемых функцией SetMenuItemBitmaps .

Windows 95: Функция GetMenuCheckMarkDimensions устарела . Используйте функцию GetsystemMetrics с параметрами CXMENUCHECK и CYMENUCHECK для извлечения размеров битовых образов.

См. также

GetMenu, GetMenuCheckMarkDimensions .

Оконные процедуры

WindowProc

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

LRESULT CALLBACK WindowProc (

HWND hwnd , // дескриптор окна

UINT uMsg , // идентификатор сообщения

WPARAM wParam , // первый параметр сообщения

LPARAM lParam // второй параметр сообщения

);

Параметры

hWnd - идентифицирует окно, получающее сообщение.

uMsg - определяет сообщение.

wParam - определяет дополнительную информацию, зависящую от сообщения.

lParam - определяет дополнительную информацию, зависящую от сообщения.

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

Возвращаемое значение представляет собой результат обработки сообщения и зависит от сообщения.

Комментарии

WindowProc является "заполнителем" для имени определяемой приложением функции.

См. также

CallWindowProc, DefWindowProc, RegisterClass .

Строки

CharPrev

Функция CharPrev возвращает указатель на предшествующий символ в строке. Функция заменяет функцию AnsiPrev .

LPTSTR CharPrev (

LPCTSTR lpszStart , // указатель на первый символ

LPCTSTR lpszCurrent // указатель на текущий символ

);

Параметры

lpszStart - указатель на начало строки.

lpszCurrent - указатель на текущий символ в завершающейся нулем строке.

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

В случае успеха возвращается указатель на предшествующий символ в строке, или на первый символ в строке, если значения параметров lpszCurrent и lpszStart совпадают.

См. также

CharNext, CharPrevExA .

CharToOem

Функция CharToOem преобразует строку в набор символов ОЕМ. Эта функция заменяет функцию AnsiToOem .

BOOL CharToOem (

LPCTSTR lpszSrc , // указатель на преобразуемую строку

LPSTR lpszDst // указатель на буфер для преобразованной строки

);

Параметры

lpszSrc - указывает на завершающуюся нулем преобразуемую строку.

lpszDst - указывает на буфер для преобразованной строки. Если CharToOem используется как ANSI -функция, то можно установить параметр lpszDst на тот же адрес, что и параметр lpszSrc . Это не может быть осуществлено в случае использования CharToOem как Unicode -функции.

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

Всегда возвращается ненулевое значение.

См. также

CharToOemBuff, OemToChar, OemToCharBuff .

CharToOemBuff

Функция CharToOemBuff преобразует указанное количество символов в строке в набор символов ОЕМ. Эта функция заменяет функцию AnsiToOemBuff .

BOOL CharToOemBuff (

LPCTSTR lpszSrc , // указатель на преобразуемую строку

LPSTR lpszDst , // указатель на преобразованную строку

DWORD cchDstLength // длина преобразуемой строки в байтах

);

Параметры

lpszSrc - указывает на завершающуюся нулем преобразуемую строку.

lpszDst - указывает на буфер для преобразованной строки. Если CharToOemBuff используется как ANSI -функция, то можно установить параметр lpszDst на тот же адрес, что и параметр lpszSrc . Это не может быть осуществлено в случае использования CharToOemBuff как Unicode -функции.

cchDstLength - определяет количество символов для преобразования в строке, идентифицируемой значением параметра lpszSrc .

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

Всегда возвращается ненулевое значение.

См. также

CharToOem, OemToChar, OemToCharBuff .

EnumCodePagesProc

Функция EnumCodePagesProc является определяемой приложением функцией обратного вызова. Она вызывается в результате вызова функции EnumSystemCodePages , и получает указатель на строковый буфер, содержащий идентификатор кодовой страницы.

BOOL CALLBACK EnumCodePagesProc (

LPTSTR lpCodePageString // указатель на строку идентификатора

// кодовой страницы

);

Параметры

lpCodePageString - указатель на строковый буфер, содержащий завершающуюся нулем строку идентификатора кодовой страницы.

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

Для продолжения перечисления функция обратного вызова должна возвращать TRUE.

Для остановки перечисления, функция обратного вызова должна возвращать FALSE.

Комментарии