На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetMenuString



The GetMenuString function copies the text string of the specified menu item into the specified buffer.

GetMenuString works, but is obsolete. Use GetMenuItemInfo instead.

int GetMenuString(

HMENU hMenu, // handle to the menu
UINT uIDItem, // menu item identifier
LPTSTR lpString, // pointer to the buffer for the string
int nMaxCount, // maximum length of the string
UINT uFlag // menu flags
);


Parameters

hMenu

Identifies the menu.

uIDItem

Specifies the menu item to be changed, as determined by the uFlag parameter.

lpString

Points to the buffer that is to receive the null-terminated string.
If lpString is NULL, the function returns the length of the menu string.

nMaxCount

Specifies the maximum length, in characters, of the string to be copied. If the string is longer than the maximum specified in the nMaxCount parameter, the extra characters are truncated.
If nMaxCount is 0, the function returns the length of the menu string.

uFlag

Specifies how the uIDItem parameter is interpreted. This parameter must be one of the following values:

Value Meaning
MF_BYCOMMAND Indicates that uIDItem gives the identifier of the menu item. If neither the MF_BYCOMMAND nor MF_BYPOSITION flag is specified, the MF_BYCOMMAND flag is the default flag.
MF_BYPOSITION Indicates that uIDItem gives the zero-based relative position of the menu item.


Return Values

If the function succeeds, the return value specifies the number of characters copied to the buffer, not including the terminating null character.
If the function fails, the return value is zero.

Remarks

The nMaxCount parameter must be one larger than the number of characters in the text string to accommodate the terminating null character.
If nMaxCount is 0, the function returns the length of the menu string.

See Also

GetMenuItemID


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetMenuString



Функция GetMenuString копирует текстовую строку определенного пункта меню в определенный буфер.

GetMenuString ПРОКЛАДЫВАЕТ, но устаревший. Используйте GetMenuItemInfo взамен.

int GetMenuString(

HMENU hMenu, // РУЧКА в меню UINT uIDItem, // идентификатор пункта меню LPTSTR lpString, // указатель в буфер для строки int nMaxCount, // максимальная длина флагов меню строки UINT uFlag //
);


Параметры

hMenu

Идентифицирует меню.

uIDItem

Определяет пункт меню, который нужно изменять, как определено параметром uFlag.

lpString

Точки на буфер, которые должны получать недействительный расторгнутую строку.
Если lpString НЕДЕЙСТВИТЕЛЬНО, функция возвращает длину строки меню.

nMaxCount

Определяет максимальную длину, в символах, строки, которая нужно копироваться. Если строка более длинная чем максимум определенный в параметре nMaxCount, дополнительные символы исключены.
Если nMaxCount - 0, функция возвращает длину строки меню.

uFlag

Определяет как параметр uIDItem интерпретирован. Этот параметр должен быть одним из следующего величин:

Значение Величины
MF_BYCOMMAND Указывает, что uIDItem дает идентификатор пункта меню. Если ни MF_BYCOMMAND ни флаг MF_BYPOSITION определен, флаг MF_BYCOMMAND является по умолчанию флагом.
MF_BYPOSITION Указывает, что uIDItem дает базирующуюся нулевую относительную позицию пункта меню.


Обратные Величины

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

Замечания

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

Смотри Также

GetMenuItemID


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz