On-line: гостей 0. Всего: 0 [подробнее..]
АвторСообщение



Пост N: 27
Зарегистрирован: 05.06.07
ссылка на сообщение  Отправлено: 19.10.07 10:26. Заголовок: Косяки документации


Предлагаю сделать такую ветку постоянно действующей т.к. топичная информация никогда не переведется
Со временем затирать исправленные замечания.

И сейчас, в связи с тем, что пришлось очень много ее (документацию) штудировать,
я нашел много серьезных несоответствий сильно затрудняющих процесс программирования.

Примеры

Все описания 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 )







Спасибо: 0 
ПрофильЦитата Ответить
Ответов - 32 , стр: 1 2 All [только новые]


Ответов - 32 , стр: 1 2 All [только новые]
Ответ:
1 2 3 4 5 6 7 8 9
большой шрифт малый шрифт надстрочный подстрочный заголовок большой заголовок видео с youtube.com картинка из интернета картинка с компьютера ссылка файл с компьютера русская клавиатура транслитератор  цитата  кавычки моноширинный шрифт моноширинный шрифт горизонтальная линия отступ точка LI бегущая строка оффтопик свернутый текст

показывать это сообщение только модераторам
не делать ссылки активными
Имя, пароль:      зарегистрироваться    
Тему читают:
- участник сейчас на форуме
- участник вне форума
Все даты в формате GMT  3 час. Хитов сегодня: 177
Права: смайлы да, картинки да, шрифты да, голосования нет
аватары да, автозамена ссылок вкл, премодерация откл, правка нет