Методы окна документа

Создание экземпляра объекта Окно документа выполняется автоматически объектом Прикладная задача. Объект Окно документа не генерирует событий, поэтому методы соответствующего класса (TPanWindow) не должны переопределяться. Класс TPanWindow используется только для управления окном документа. События, связанные с окном направляются объекту Обработчик команды, если он создан.

Методы класса TPanWindow можно разделить на несколько групп по их предназначению :

- запрос справочной информации;

- масштабирование и пересчет координат;

- отображение выполнения потоковой задачи;

- запрос и обработка информации об объекте карты;

- управление выводом комментариев;

- оконный интерфейс электронной карты;

Cправочную информацию можно запросить следующими методами :

GetApplicationName   - запросить имя приложения,

GetIniName                - запросить имя файла "ini" приложения,

GetMapIniName         - запросить имя файла "ini" карты,

GetHelpName            - запросить имя файла справки приложения (*.CHM),

GetLanguage             - запросить код текущего языка диалогов приложения,

GetPanelState            - запросить состояние панели инструментов (отображена

                                    или нет),

GetPathShell              - запросить путь к директории приложения,

GetUserName            - запросить имя пользователя,

GetDocPath               - запросить имя файла документа.

Методы запроса имени приложения, имен файлов "chm" и "ini" могут возвращать значения, установленные из класса прикладной задачи в соответствующие переменные класса TPanWindow.

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

ChangeScale            - изменить текущий масштаб изображения,

Client2Picture           - преобразовать координат точки клиентной области

                                  в координаты изображения,

Picture2Client           - преобразовать координаты точки изображения карты

                                  в координаты клиентной области окна,

PlaneToClient           - преобразование координат точки на местности (метры)

                                   к координатам клиентной области,

SetPicturePoint         - установить координаты левого верхнего угла окна карты,        

GetPicturePoint         - запросить координаты левого верхнего угла окна карты,

Отображение процентов выполнения потоковой задачи в информационной линейке ГИС Панорама реализуется следующими методами :

CreateProgress         - запустить линейку с процентом выполнения процесса и

                                   названием;

SetProgressPercent  - изменить процент выполнения процесса;

DeleteProgress          - убрать линейку выполнения процесса.

Запрос и обработка информации об объекте карты выполняется следующими методами :

SetSelectObject     - установить выбранный объект, выбранный объект       автоматически  будет выделен на карте;

IsObjectSelected      - запросить идентификатор выбранного объекта;

ClearSelect              - отменить выбор объекта;

ViewObject           - отобразить участок карты, на котором расположен заданный объект, в     определенном фрагменте окна;

ViewPlanePoint     - отобразить участок карты, на котором расположена заданная точка, (в   метрах) в центре окна;

SetViewSelect     - установить выделение объектов на карте по обобщенным условиям   поиска/выделения объектов.

Управление выводом комментариев выполняется следующими методами :

SetMessage           - вывести сообщение в информационную строку ГИС Панорама;

SetWindowTitle      - вывести сообщение в заголовок окна карты;

ClearWindowTitl     - убрать сообщение из заголовка окна;

ViewHelp                - отобразить указанный раздел справки из файла "CHM" приложения;

PressButton           - нажать кнопку для указанной команды на всех панелях, где она есть;

ReleaseButton        - отжать кнопку для указанной команды.

Оконный интерфейс электронной карты реализуется следующими методами :

GetHandle             - запросить идентификатор (HWND) окна карты;

GetParentHandle  - запросить идентификатор (HWND) родительского окна карты;

GetMainHandle     - запросить идентификатор (HWND) главного окна приложения;

GetCursorPos       - запросить позицию курсора в окне;

GetClientRect        - запросить размер клиентной области окна карты;

GetMainClientRec -запросить размер клиентной области главного окна приложения;

ScreenToClient     - пересчет экранных координат;

SendMessage       - отправить сообщение окну карты с ожиданием выполнения;

PostMessage        - отправить сообщение окну карты без ожидания;

MainMessage        - отправить сообщение главному окну с ожиданием выполнения;

Invalidate               - отправить сообщение окну карты на перерисовку окна;

InvalidateRect        - отправить сообщение окну карты на перерисовку фрагмента окна;

InvalidateRectPlane-отправить сообщение окну карты на перерисовку фрагмента окна,     заданного прямоугольными координатами (в метрах);

UpdateWindow        - перерисовать окно карты немедленно.

Описание класса TPanWindow содержится в файле PANWIN.H, реализация - в файле PANTASK.CPP. Файлы расположены в папке \SDK\PANTASK примеров разработки приложений в ГИС "Панорама" 12.