Space & Aero Pictures Processing Laboratory Home Page

Графический интерфейс

Типовые пользовательские классы обьектов

Элементы управления:

• TCObject - Базовый абстрактный класс управляющих элементов (кнопки, списки выбора и т.д.).
  
• TDrawButton - Нажимаемая кнопка с битмэпом.
  
• TCombox - Выпадающий список выбора.
  
• TPullDownMenu - Выпадающее меню (пока реализованно в виде отдельного класса).
  
• TPopUpMenu - Всплывающее меню.
  

Элементы размещения:

• TMenuBar - Бар для размещения выпадающих меню.
  
• TControlBar - Бар для размещения объектов класса TCObject.
  

Шаблоны оконных елементов.

• XomWidget - Базовый абстрактный класс.
  
• XomInit - Объект этого класса инициализирует libXom и создает ApplicationShell.
  
• XomShell - Создание Shell - объекта верхнего уровня.
  
• XomShellForm - Создание Shell - объекта верхнего уровня с инкапсулированным объектом класса XomMainForm.
  
• XomBaseBoard - Создание xmBulletinBoardWidgetClass.
  
• XomMainWindow - Шаблон окна приложения или окна верхнего уровня с информационными метками.
  
• XomMainForm - Аналогичен XomMainWindow, но добавляет к нему объект класса TMenuBar.
  
• XomDraw - Создание xmDrawingAreaWidgetClass.
  
• XomScrolledDraw - Создание xmScrolledDrawingAreaWidgetClass.
  
• XomInfo - Информационный диалог.
  
• XomMessDialog - Диалог вывода сообщений для подтверждения или отмены.
  
• XomMarkBar - Класс объекты которого служат для размещения на них объектов класса XomMarkForm, с автоматическим выравниванием закладок.
  
• XomMarkForm - Шаблон окна со свойствами xmFormWidgetClass для создания многоуровневых диалогов с закладками.
  
• XomFileSelectionDialog - Стандартное окно выбора файлов.
  
• XomHlpBoard - Форматированный вывод HTML-текста в окно.
  
• XomHlpMainForm - Класс предоставляющий организацию интерфейса гипертекстовой подсказки.
  

Вспомогательные классы

• xomMessout - Обработка локализованных сообщений (для диалогов, статусбаров и т.д.). Честно говоря, неудачное название.
  
• xomRWEvents - Чтение/запись X-событий из/в файл (для создания демо-версий).
  
• error_code_class - Вспомогательный класс обработки исключительных ситуаций (не прибегая к средствам С++).
  
• ErrorCodeClass - Виртуальный класс наследуемый всеми другими классами (если это конечно надо) для обработки ошибок. Инкапсулирует error_code_class.
  
• Percent - Слежение за степенью выполнения больших циклов (обработка прерываний этих циклов).
  
• PercentShadow - Пустой Percent.
  
• TString - Заменитель типа char*.
  
• TPicter - Работа с картинками (TPicter==TPicture - так уж вышло).
  

Описание

XomWidget

Открытый конструктор :

Открытый деструктор :

Открытые методы :

virtual Destroy()=0
Вызывается в ~XomWidget(), обычно используется для определения правил удаления оконных елементов (widget).

virtual Widget TopLevel()=0
Определяет widget верхнего уровня текущего класса.

virtual XtAppContext AppContext()
Возвращает контекст приложения.

virtual Display* DisplayXom()
Возвращает текущий экран (дисплей).

virtual Visual* VisualXom()
Возвращает характеристики дисплея.

virtual Window Wnd()
Возвращает идентификатор Х-окна.

virtual int Screen()
Возвращает номер экрана.

virtual Colormap DefColorMap()
Возвращает идентификатор текущей аппаратной палитры по умолчанию.

virtual Colormap ColorMap()
Возвращает идентификатор логической палитры текущего объекта.

virtual SetCursor(Cursor crs)
Устанавливает курсор окна в значение crs.

virtual Cursor GetCursor()
Получает курсор текущего окна.

virtual short *SetColors(unsigned char *data, int Height , int Width, short *color_list, short &color_cells, Boolean installcmp)
Привести логическую палитру окна в состветствии с палитрой color_list изображения data размером HeightxWidth;
Аргументы:
data - массив пикселей сответсвующих номерам в color_list, Red-состовляющая=color_list[0 - color_cells-1], Green-состовляющая=color_list[color_cells - 2*color_cells-1], Blue-состовляющая=color_list[2*color_cells - 3*color_cells-1],
Height, Width - размерность картинки;
color_list - палитра;
color_cells - размерность палитры;
installcmp - если TRUE упорядочить данные в соответсвии с новой палитрой и инсталировать логическую палитру в аппаратную, иначе FALSE.
Возвращаемое значение:
Если installcmp=TRUE, возвращает приведенную палитру если installcmp=TRUE, color_cells - присваевается новый размер новой палитры.

virtual short *SetColors(short *color_list, short &color_cells, unsigned char *index)
Привести логическую палитру окна в состветствии с палитрой color_list и вернуть индексы упорядочиния data[i] = index[data[i]];
Аргументы:
color_list - палитра;
color_cells - размерность палитры;
index - индексы упорядочиния data, массив должн быть аллокирован перед использованием.
Возвращаемое значение:
Возвращает неприведенную палитру, color_cells - присваевается новый размер новой палитры.

virtual Colormap SetColormap(short *color_list, short color_cells)
Установить логическую палитру окна в состветствии с палитрой color_list. Добавить в список EventHendlers для инсталяции логической палитры в аппаратную при перемещении курсора на окно.
Аргументы:
color_list - палитра;
color_cells - размерность палитры;
Возвращаемое значение:
Возвращает идентификатор логической палитры.

virtual Boolean AddColormap()
Добавляет в список EventHendler для инсталяции логической палитры в аппаратную при перемещении курсора на окно.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual short *GetColors(short &color_cells)
Получить текущую палитру цветов. Аргументы:
color_cells - размерность палитры;
Возвращаемое значение:
Возвращает текущий массив цветов палитры объекта. color_cells присваевается размерность массива.

virtual XColor *GetXomColors(short &color_cells)
Получить текущую палитру цветов в формате X-Window.
Аргументы:
color_cells - размерность палитры;
Возвращаемое значение:
Возвращает указатель на структуру XColor объекта. color_cells присваевается размерность палитры.

virtual int SetWidth(int width)
Изменить текущую ширину окна объекта. Аргументы:
width - новая ширина окна.
Возвращаемое значение:
Возвращает не 0 если размер можно изменить.

virtual int Width()
Возвратить текущую ширину окна объекта.
Возвращаемое значение:
Возвращает текущую ширину окна объекта или 0 если для данного класса объектов операция не выполнима.

virtual int SetHeight(int height)
Изменить текущую высоту окна объекта.
Аргументы:
height - новая высота окна.
Возвращаемое значение:
Возвращает не 0 если размер можно изменить.

virtual int Height()
Возвратить текущую высоту окна объекта.
Возвращаемое значение:
Возвращает текущую высоту окна объекта или 0 если для данного класса объектов операция не выполнима.

virtual GC GetGC()
Возвратить текущий графический контекст окна объекта.
Возвращаемое значение:
Возвращает графический контекст окна объекта или 0 если для данного класса объектов операция не выполнима.

virtual Boolean SetGC(GC pgc)
Возвратить текущий графический контекст окна объекта.
Аргументы:
pgc - новый графический контекст окна.
Возвращаемое значение:
Возвращает FALSE если для данного класса объектов операция не выполнима.

virtual Widget BaseWidget(Widget w)
Установить атрибут BaseWidget объекта.
Аргументы:
w - созданный widget, который предполагается ипользовать как родительский для создания новых widget.
Возвращаемое значение:
Возвращает тип установленного атрибута.

virtual Widget BaseWidget()
Получить атрибут BaseWidget объекта.
Возвращаемое значение:
Возвращает тип установленного атрибута.

virtual Widget LeftWidget(Widget w)
Установить атрибут левого widget объекта для класса Motif XmForm, в случае работы с формами.
Аргументы:
w - атрибут левого widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута.

virtual Widget LeftWidget()
Получить атрибут левого widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута или NULL если класс widget не принадлежит XmForm.

virtual Widget RightWidget(Widget w)
Установить атрибут правого widget объекта для класса Motif XmForm, в случае работы с формами.
Аргументы:
w - атрибут правого widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута.

virtual Widget RightWidget()
Получить атрибут правого widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута или NULL если класс widget не принадлежит XmForm.

virtual Widget TopWidget(Widget w)
Установить атрибут верхнего widget объекта для класса Motif XmForm, в случае работы с формами.
Аргументы:
w - атрибут верхнего widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута.

virtual Widget TopWidget()
Получить атрибут верхнего widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута или NULL если класс widget не принадлежит XmForm.

virtual Widget BottomWidget(Widget w)
Установить атрибут нижнего widget объекта для класса Motif XmForm, в случае работы с формами.
Аргументы:
w - атрибут нижнего widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута.

virtual Widget BottomWidget()
Получить атрибут нижнего widget объекта для класса Motif XmForm.
Возвращаемое значение:
Возвращает тип установленного атрибута или NULL если класс widget не принадлежит XmForm.

virtual Boolean PrintToMessageWindow (char *mess)
Напечатать собщение, подсказку ... mess в статусбаре окна верхнего уровня.
Аргументы:
mess - строка сообщения.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual char *MessageStr ()
Получить собщение, подсказку ... напечатанное в статусбаре окна верхнего уровня.
Возвращаемое значение:
Возвращает указатель на строку в случае успеха или NULL.

virtual Boolean PrintToInfo(char *info, int)
Напечатать строку info в информационной метке n статусбара окна верхнего уровня.
Аргументы:
info - строка сообщения.
n - номер метки.
Возвращаемое значение:
Возвращает TRUE если n <= числа меток.

virtual char *InfoLabel(int number)
Получить собщение, подсказку ... напечатанное в метке number статусбарфа окна верхнего уровня.
Аргументы:
nnumber - номер метки.
Возвращаемое значение:
Возвращает указатель на строку в случае успеха или NULL.

virtual int NumberInf()
Получить число меток. Возвращаемое значение:
Возвращает число информационных меток статусбара.

virtual char *CurentDir()
Получить текущее имя дериктории с которым связано окно (приложение).
Возвращаемое значение:
Возвращает указатель на строку в случае успеха или NULL.

virtual Boolean SetCurentDir(char * dir)
Установить текущее имя дериктории с которым связано окно (приложение).
Аргументы:
full_filename - полное имя файла.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual Boolean SetFileName(char *full_filename)
Установить текущее имя файла с которым связано окно (приложение).
Аргументы:
full_filename - полное имя файла.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual char *GetFileName()
Получить текущее имя файла с которым связано окно (приложение).
Возвращаемое значение:
Возвращает указатель на строку в случае успеха или NULL.

virtual Boolean ReDraw(void* pointer=NULL)
Перерисовка окна с новыми деннами по указателю pointer. В базовом классе не определена, а только устанавливает новое значение клиентской памяти.
Аргументы:
pointer - указатель на область памяти с клиентскими данными.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual Boolean AddRedraw()
Добавление реакции на X-событие Expouse.
Возвращаемое значение:
Возвращает TRUE если ранее добаления не происходило.

virtual Boolean AddControlCursor()
Добавление реакции на X-события порождаемые мышью.
Возвращаемое значение:
Возвращает TRUE если ранее добаления не происходило.

virtual Boolean B1MotionExecFunction()
Выполняется при передвижении указателя мыши и нажатой левой конпке если ранее бала произведно добавление реакций на X-события порождаемые мышью.
Возвращаемое значение:
Возвращает TRUE если ранее добаления не происходило.

virtual Boolean B1PressExecFunction()
Выполняется при нажатии левой конпки если ранее бала произведно добавление реакций на X-события порождаемые мышью.
Возвращаемое значение:
Возвращает TRUE если ранее добаления не происходило.

virtual Boolean GetCursorXY(int &x, int &y)
Получить текущие координаты указателя мыши.
Аргументы:
x - получаемое значение по оси X в пикселах.
y - получаемое значение по оси Y в пикселах.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual Boolean GetPressCursorXY(int &x, int &y)
Получить координаты указателя мыши по результатам последнего нажатия левой или средней кнопки.
Аргументы:
x - получаемое значение по оси X в пикселах.
y - получаемое значение по оси Y в пикселах.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual Boolean GetMotionCursorXY(int &x, int &y)
Получить текущие координаты указателя мыши.
Аргументы:
x - получаемое значение по оси X в пикселах.
y - получаемое значение по оси Y в пикселах.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual Boolean Timer(int &s, int &m, int &h)
Получить текущее время таймера приложения.
Аргументы:
s - секунд от начала минуты.
m - минут от начала часа.
h - часов от начала сеанса работа приложения.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual char *TimerStr()
Получить текущее время таймера приложения.
Возвращаемое значение:
Возвращает указатель на строку имеющей формат ss:mm:hh.

virtual Boolean AddTimer(int deltatime)
Добавить таймер приложения.
Аргументы:
deltatime - время в милисекундах через которое производится обновление таймера и вызов TimerExecFunction.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual Boolean TimerExecFunction()
Выполняется каждые deltatime если ранее был заведен таймер приложения.
Возвращаемое значение:
Возвращает TRUE если ранее добаления не происходило.

virtual XImage *CreateImage(Widget widget, unsigned char *data, int width, int height )
Создать образ окна по данным из массива data шириной width и высотой height. Аргументы:
widget - окно.
data - массив номеров пикселей в палитре, палитра может быть предварительно установлена функцией SetColormap.
width, height - размерность массива.
Возвращаемое значение:
Возвращает указатель на образ окна XImage если создать его не удалось возвращает NULL.

virtual Boolean PutImage(Widget widget, XImage *Image)
Нарисовать окно XImage. Аргументы:
widget - окно.
Image - образ окна.
Возвращаемое значение:
Возвращает TRUE в случае успеха.

virtual TMenuBar* GetMenuBar()
Получить указатель на объект класса TMenuBar.
Возвращаемое значение:
Возвращает указатель на объект класса TMenuBar если он есть у окна, иначе NULL.

virtual TPopUpMenu* GetPopupMenu()
Получить указатель на объект класса TPopUpMenu.
Возвращаемое значение:
Возвращает указатель на объект класса TPopUpMenu если он есть у окна, иначе NULL.

int AllNumber() const
Получить число созданных объектов класса XomWidget .
Возвращаемое значение:
Возвращает число созданных объектов класса XomWidget

int NumberSelf() const
Получить собственный номер.
Возвращаемое значение:
Возвращает собственный номер созданного объекта класса XomWidget.

const XomWidget *NextObject() const
Получить указатель на следующий в списке объект.
Возвращаемое значение:
Возвращает указатель на следующий в списке объект приложения класса XomWidget.

const XomWidget *ThisObject() const
Получить указатель на собственный объект.
Возвращаемое значение:
Возвращает указатель на собственный объект приложения класса XomWidget.