Параметры
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 -функции.