3.4. Метод Circle

С помощью данного метода можно нарисовать на объекте окружность, эллипс или дугу.

object.Circle [Step](x, у), radius [, color, start, end, aspect]

• object – объект, в котором применяется метод. Если объект не указан, то по умолчанию используется форма;

• step – ключевое слово, которое показывает, что центр окружности, эллипса или дуги задается относительно текущих координат объекта object, определяемых его свойствами CurrentX и CurrentY.

• х, у – числа с плавающей точкой одинарной точности, определяющие координаты центра окружности, дуги или эллипса в единицах свойства ScaleMode объекта;

• radius – число с плавающей точкой одинарной точности, определяющее радиус окружности, дуги или эллипса в единицах свойства ScaleMode объекта;

• color – значение типа Long, задающее цвет линии. Если параметр не указан, применяется значение свойства ForeColor. Для задания цвета можно использовать функции RGB или QBColor;

• start, end – при рисовании дуги или части эллипса задает позицию начала и конца дуги в радианах: от 2π до -2π радиан; По умолчанию, для аргумента start устанавливается значение 0 радиан, а для аргумента end – 2π радиан.

• aspect – число с плавающей точкой одинарной точности задает коэффициент "эллиптичности" окружности. По умолчанию этот коэффициент равен 1.0, что соответствует окружности.

Примечания:

• Во время выполнения метода Circle значения свойств CurrentX и CurrentY становятся координатами центра окружности.

• Чтобы закрасить внутреннюю область окружности, следует задать свойства FillColor и FillStyle объекта, в котором она нарисована. Закрасить можно только замкнутую фигуру. Замкнутыми фигурами являются окружности, эллипсы и секторы (фигуры ограниченные дугой и двумя радиусами).

• Метод Circle осуществляет рисование только в направлении обратном ходу часовой стрелки (положительное направление).

• Если при изображении части окружности или эллипса аргумент start окажется отрицательным, то метод Circle проведет линию от центра к точке start, но будет использовать абсолютную величину этого угла. Таким же образом будет обработано и отрицательное значение аргумента end.

• Толщина линии окружности, эллипса или дуги определяется значением свойства DrawWidth. Способ изображения окружности относительно фона зависит от установок свойств DrawMode и DrawStyle.

• При рисовании горизонтального радиуса сектора вправо используйте в качестве значения аргумента start не ноль, а небольшое отрицательное число.

• Если требуется пропустить аргумент, стоящий в середине синтаксической последовательности для метода, то вместо него перед следующим аргументом необходимо поставить запятую. В конце синтаксической последовательности, при пропуске необязательного аргумента, запятую ставить не следует.

Пример использования графического метода Circle.

Рис. 11.2. Использование метода Circle

Пример. Нарисовать дорожный знак.

Рис. 11.2. Дорожный знак