Форум » GUI » Косяки документации » Ответить
Косяки документации
SADSTAR2: Предлагаю сделать такую ветку постоянно действующей т.к. топичная информация никогда не переведется Со временем затирать исправленные замечания. И сейчас, в связи с тем, что пришлось очень много ее (документацию) штудировать, я нашел много серьезных несоответствий сильно затрудняющих процесс программирования. Примеры Все описания Draw , например DRAW LINE IN WINDOW <WindowName> AT <nRow>,<nCol> TO <nRow>,<nCol> [PENCOLOR <anPenColor>] [PENWIDTH <nPenWidth>] А должно быть либо в одну строчку, либо каждый перенос строки должен заканчиваться ; Аналогично - TAB, DEFINE TIMER, DEFINE TREE и т.д. Эти косяки сильно маскируются (практически нивелируются) при использовании визуального форм-дизайнера, автор которого в этих тонкостях разбирался. Команда ON KEY ALT <Key> [ OF <ParentWindow>] ACTION <ActionProcedureName> | <bBlock> В списке доступных Key я не нашел нужный мне простой ESC. А, оказывается, нужно как в примере ON KEY ESCAPE ACTION Form_2.Button_2.OnClick безо всяких ALT. И еще там есть модификатор WIN Команды PUSH KEY вообще не нашел А функция SetProperty( <cWindowName>[,<cControlName>], <cPropertyName> , <PropertyValue> ) может иметь до 7 (семи) аргементов!!! И откуда это узнать? Я случайно наткнулся в текстах. Не проверять же каждое описание в документации по исходникам. А вот кстати проверим GetProperty ... Ну вот - оказывается не до 3, а до 6 (шести) аргументов. Так-так... Ну а еще проверим... DoMethod(<WindowName>,[<ControlName>],<MethodName>) - до 9 (девяти) аргументов!!! Товарищи!!! От нас скрывают всю правду!!! Всю мощь и гибкость MiniGUI!!! Есть лишние пробелы в написании имен и в др.важных местах, т.ч. просто скопировать и вставить не получится. Например Get Property (<cWindowName>[,<cControlName>] ,<cPropertyName>)--> PropertyValue Перечень команд без каких-либо объяснений Например - Image List. Наверное предполагается, что пользователи МиниГУИ знают WinAPI, и поэтому им не трудно догадаться - о чем идет речь. Аналогично - некоторые непонятные свойства некоторых контролов. ... Да... Перечитав ранее написанное я подумал, что косяков столько, что сначала нужно документацию тщательно переработать и только потом устранять редкие мелкие неточности. А как народ считает? Или никто документацией не пользуется? Всем хватает исходников? И только я, как начинающий минигуист-харборист (т.е. как лох), пользуюсь документацией. P.S. Сейчас проверил "What's New" - нашел последнее упоминание о SetProperty( ) 2006/12/05: Build 28 (HMG 1.2 Extended) Published. · Enhanced: The Tab control supports a new Image property: · function syntax SetProperty ( ParentForm, ControlName, 'IMAGE', Column, cImage ) GetProperty ( ParentForm, ControlName, 'IMAGE', Column )
Ответов - 32, стр:
1 2 All
полная версия страницы