Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.28. Вспомогательный объект для работы с модальными окнами

А.5.28.4. rdsFORMAddTab – добавить вкладку

Функция rdsFORMAddTab добавляет в объект для работы с модальным окном новую вкладку.

  void RDSCALL rdsFORMAddTabA(
    RDS_HOBJECT Win, // Объект
    int TabId,       // Идентификатор вкладки
    RDSCSTR Caption  // Заголовок вкладки (UTF8)
  );
  void RDSCALL rdsFORMAddTabW(
    RDS_HOBJECT Win, // Объект
    int TabId,       // Идентификатор вкладки
    RDSWCSTR Caption // Заголовок вкладки (UTF16)
  );
  // Функция-псевдоним
  void RDSCALL rdsFORMAddTab(
    RDS_HOBJECT Win, // Объект
    int TabId,       // Идентификатор вкладки
    RDSXCSTR Caption // Заголовок вкладки (кодировка по умолчанию)
  );

Тип указателя на эту функцию

RDS_VHoIS (для UTF8) или RDS_VHoIWs (для UTF16)

Параметры

Win (RDS_HOBJECT)

Идентификатор вспомогательного объекта для работы с модальным окном, ранее созданного функцией rdsFORMCreate.

TabId (int)

Произвольный целый идентификатор, который будет присвоен добавляемой вкладке. Этот идентификатор будет использоваться для добавления полей ввода на вкладку функцией rdsFORMAddEdit.

Caption (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с заголовком вкладки.

Примечания

Эта функция добавляет в объект Win новую вкладку с идентификатором TabId. Вкладки можно добавлять в окно только в том случае, если при создании объекта вызовом rdsFORMCreate в параметре Tabbed было передано TRUE. Вкладки добавляются слева направо, то есть каждый следующий вызов rdsFORMAddTab добавляет вкладку справа от последней добавленной. Идентификаторы вкладкам можно присваивать произвольно – главное, чтобы в одном окне не было двух вкладок с одинаковыми идентификаторами, и чтобы идентификатор вкладки не совпадал с идентификатором боковой панели окна, указанном в вызове rdsFORMEnableSidePanel.

Пример

Пример использования функции rdsFORMAddTab приведен в §2.10.1 руководства программиста.

См. также

rdsFORMCreate, rdsFORMAddEdit, rdsFORMEnableSidePanel.