Приложения
Приложение А. Функции, константы и структуры RDS
А.5. Сервисные функции и макросы RDS
А.5.31. Вспомогательный объект для панелей в окне подсистемы
А.5.31.3. Команда RDS_PAN_CAPTION – заголовок панели
Команда RDS_PAN_CAPTION устанавливает или возвращает заголовок панели.
Вызов команды для установки
RDSCSTR sCaption= … // Строка заголовка (UTF8) rdsSetObjectStrA(Panel,RDS_PAN_CAPTION,0,sCaption);
или
RDSWCSTR sCaption= … // Строка заголовка (UTF16) rdsSetObjectStrW(Panel,RDS_PAN_CAPTION,0,sCaption);
или (через функцию-псевдоним)
RDSXCSTR sCaption= … // Строка заголовка (кодировка по умолчанию) rdsSetObjectStr(Panel,RDS_PAN_CAPTION,0,sCaption);
Вызов команды для чтения
RDSCSTR sCaption=rdsGetObjectStrA(Panel,RDS_PAN_CAPTION,0); // UTF8
или
RDSWCSTR sCaption=rdsGetObjectStrW(Panel,RDS_PAN_CAPTION,0); // UTF16
или (через функцию-псевдоним)
RDSXCSTR sCaption=rdsGetObjectStr(Panel,RDS_PAN_CAPTION,0); // Кодировка по умолчанию
Параметры и результат
- Panel (RDS_HOBJECT)
- Идентификатор вспомогательного объекта-панели, ранее созданного функцией rdsPANCreate.
- sCaption (RDSCSTR, RDSWCSTR, RDSXCSTR)
- Указатель на строку с заголовком панели. При получении заголовка функция rdsGetObjectStr возвращает указатель на строку во внутренней памяти объекта, он будет действительным до следующего изменения заголовка.
Примечания
Эта команда управляет строкой, которая отображается в полосе заголовка панели. Если у панели нет рамки или полосы заголовка, строка заголовка отображаться не будет, но она все равно будет храниться во внутренней памяти объекта, и ее можно будет получать и устанавливать.
См. также