Форум » 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

Петр: Григорий, minigui.txt - это хорошо. Но я имел ввиду именно ch файл с extern объявлениями. gfilatov пишет: Это реально (!?) - уж больно специфический продукт для русскоязычной аудитории, привыкшей к бесплатным СИ-билдеру, Дельфи и т.п. Я думаю сильно помог бы русскоязычный файл помощи. Кстати и желающие помочь в его создании есть - SADSTAR и G-Serge

G-Serge: Петр пишет: Я думаю сильно помог бы русскоязычный файл помощи. Кстати и желающие помочь в его создании есть - SADSTAR и G-Serge Спасибо за доверие Но скорее всего времени не будет. А пока неплохо обхожусь файлом помощи англоязычным и исходниками собственно библиотеки. А вот ОТДЕЛЬНЫЙ раздел обмена опытом и взаимопомощи, повторюсь, не помешает.

Петр: На нет и суда нет Лично мне тоже исходников хватает ( для open source это в общем общепринятая практика, редко какой проект может похвастаться полноценной справочной системой ). Но это крайне важно для развития проекта. Вот вы беспокоитесь, а не будут ли в следующем релизе внесены какие-то изменения влияющие на работу моей программы. А задаться вопросом - будет ли следующий релиз вы не пробовали? По поводу отдельного раздела. Это вопрос к администратору. Вдруг он (администратор) окажется отзывчивым человеком Но, по моему для этого и есть форум. Создание нового раздела - ничего не решит. Ведь по сути весь раздел GUI держится на активности Григория Филатова На практике обмен опытом и взаимопомощь чаще всего выглядит так, как я писал : мне нужно - начинаю задавать вопросы и возмущаться, что никто не хочет ответить. Написал программу - забыл о форуме. А с какой стати отвечать? Да еще человеку который на форуме раз в месяц появляется - по крайней нужде. IMHO yужно - ищи, учи.


G-Serge: Петр пишет: На практике обмен опытом и взаимопомощь чаще всего выглядит так, как я писал : мне нужно - начинаю задавать вопросы и возмущаться, что никто не хочет ответить. Написал программу - забыл о форуме. А с какой стати отвечать? Да еще человеку который на форуме раз в месяц появляется - по крайней нужде. Человек, написавший программу и забИвший на форум - забИвает не столько на форум, сколько на MiniGUI. Надеюсь, последнее очевидно. Интересен проект - читают форум и по возможности пишут на него, проект неинтересен - ну и форум тогда вместе с проектом побоку. Просто и логично. Мне проект интересен. По этой причине и ищу, и учу, и вопросы задаю задаю на форуме, поскольку не всё смог найти. Но если бы все вопросы по библиотеке были бы более-менее СИСТЕМАТИЗИРОВАНЫ, что я и предлагаю сделать введением отдельного раздела, это сделало бы форум как минимум привлекательнее. По крайней мере, не придётся при каждом новом вопросе весь форум перерывать, и спрашивать то, о чем уже десять раз разжевали :) Петр пишет: По поводу отдельного раздела. Это вопрос к администратору. Вдруг он (администратор) окажется отзывчивым человеком При желании, на fastbb.ru не проблема сделать даже отдельный форум. И назначить администратором на нём себя, любимого.

gfilatov: G-Serge пишет: на fastbb.ru не проблема сделать даже отдельный форум Это так Но задача состоит не в том, чтобы плодить еще один форум, который будет посещать 1 или 2 или 3 заинтересованных лица IMHO Проблема в том, чтобы как можно больше людей могли участвовать в проекте и сказать G-Serge пишет: Мне проект интересен.

G-Serge: Григорий, я всего лишь предлагаю способ НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ информацию о различных составляющих проекта КОЛЛЕКТИВНО, общедоступно и по возможности без проволочек. А отдельный раздел или даже форум использовать просто как своеобразный справочник, поскольку это самый дешёвый способ эту самую коллективность и общедоступность организовать.

Петр: G-Serge пишет: я всего лишь предлагаю способ НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ А кто против? Осталось технические детали уладить Я согласен с Григорием, новый форум открывать не стоит ( как и уходить с англоязычного форума HMG ). Ведь очевидно, что целевая аудитория - пользователи [x]Harbour. И думаю Dima тоже ничего против иметь не будет, чтобы открыть новый раздел. Но чтобы "НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ информацию о различных составляющих проекта" одной коллективной работы мало будет. Кому-то нужно будет поработать модератором, кому координировать работу, причем уделять всему этому достаточно времени, хотя бы на начальном этапе. И здесь "скорее всего времени не будет" не пройдет.

G-Serge: Петр пишет: И здесь "скорее всего времени не будет" не пройдет. Вы процитировали мой ответ на предмет работы над русскоязычным файлом помощи. На мой взгляд, это работа очень трудоёмкая, если заниматься ей всерьёз. Поэтому просто не берусь. Петр пишет: Но чтобы "НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ информацию о различных составляющих проекта" одной коллективной работы мало будет. Кому-то нужно будет поработать модератором, кому координировать работу, причем уделять всему этому достаточно времени, хотя бы на начальном этапе. Ну, как говорится - ЛИХА БЕДА НАЧАЛО :) Глядишь, и тронется лёд в нужном направлении.

Петр: Хорошо. Хотелось бы увидеть мнения Григория и Dima.

gfilatov: Петр пишет: ЛИХА БЕДА НАЧАЛО Просто откройте новую тему в ветке GUI этого форума под названием "MiniGUI FAQ", например. G-Serge пишет: тронется лёд в нужном направлении

G-Serge: gfilatov пишет: Просто откройте новую тему в ветке GUI этого форума под названием "MiniGUI FAQ", например. Сдаётся мне, не будет этого достаточно. Со временем запросто может получиться винегрет из различающихся по специфике вопросов ( причем трудно предположить, на сколько страниц эта ТЕМА протянется ), в котором опять-же придётся рыться всякий раз. Тогда уж хотя бы создавать отдельные темы по каждому из более-менее частых вопросов и имеющихся контролов и функций в частности - если ПО ДРУГОМУ ну никак не получается. Но впрочем - дело хозяйское

Петр: G-Serge пишет: Сдаётся мне, не будет этого достаточно Если относиться к этому серьезно, то конечно этого не будет достаточно. Нужно открывать новую ветку, создать несколько тем, в т.ч. и sticky - приклеенных (например - новости, документация, инструментарий). И права модератора, если не администратора очень желательны.



полная версия страницы