Шаг 273.
Автоматизация Microsoft PowerPoint.
Свойства и методы коллекции Shapes
На этом шаге мы перечислим свойства и методы коллекции Shapes.
Все элементы на поверхности слайда - будь то пустой местозаполнитель, текст или автофигура, рисунок или OLE-объект -
представлены коллекцией Shapes. Собственно, в визуальном отношении слайд состоит из набора Shape-объектов и фона
(заднего плана). Свойства и методы коллекции Shapes используются для манипуляций с Shape-объектами, принадлежащими
данному слайду.
Свойства
Перечислим свойства этой коллекции.
- Count - число Shape-объектов в коллекции и соответственно на слайде.
- HasTitle - возвращает логическое значение True, если коллекция содержит заголовок.
- Title - содержит Shape-объект, представляющий заголовок слайда.
Методы
Прежде чем рассматривать методы, заметим, что некоторые из них мы уже использовали при изучении соответствующих объектов.
Метод AddCallout включает в состав коллекции и помещает на слайд новую выноску с заданными параметрами. Общий вид:
AddCallout(Type, Left, Top, Width, Height),
где
- Type - константа, определяющая тип выноски. Возможные значения (в скобках - соответствующие числовые значения):
msoCalloutFour (4), msoCalloutOne (1), msoCalloutThree (3), msoCalloutTwo (2).
- Left, Top - координаты (в пунктах) левого верхнего угла выноски.
- Width, Height - размеры выноски в пунктах.
Метод AddComment включает в состав коллекции Shapes и помещает на слайд примечание. Общий вид:
AddComment(Left, Top, Width, Height),
где
- Left, Top - координаты (в пунктах) левого верхнего угла примечания.
- Width, Height - размеры примечания в пунктах.
Метод AddConnector включает в состав коллекции Shapes и помещает на слайд соединительную линию.
Непосредственно после создания линия ни к чему не присоединена (для этого необходимо воспользоваться методами BeginConnect
и EndConnect). Более подробную информацию по этому методу можно получить на 254 шаге.
Общий вид:
AddConnector(Type, BeginX, BeginY, EndX, EndY),
где
- Type - константа, определяющая тип соединительной линии. Возможные значения:
- msoConnectorCurve (3) - скругленная соединительная линия;
- msoConnectorElbow (2) - соединительная линия уступом;
- msoConnectorStraight (1) - прямая соединительная линия.
- BeginX, BeginY - координаты начала линии.
- EndX, EndY - координаты конца линии.
Метод AddLabel включает в состав коллекции Shapes и помещает на слайд надпись. Общий вид:
AddLabel(Orientation, Left, Top, Width, Height),
где
- Orientation - константа, определяющая ориентацию текста надписи. Возможные значения:
msoTextOrientationDownward (3), msoTextOrientationHorizontal (1), msoTextOrientationHorizontalRotatedFarEast (6),
msoTextOrientationUpward (2), msoTextOrientationVertical (5), msoTextOrientationVerticalFarEast (4).
- Left, Top - координаты (в пунктах) левого верхнего угла надписи.
- Width, Height - размеры надписи в пунктах.
Метод AddLine включает в состав коллекции Shapes и помещает на слайд линию. Общий вид:
AddLine(BeginX, BeginY, EndX, EndY),
где
- BeginX, BeginY - координаты начала линии.
- EndX, EndY - координаты конца линии.
Метод AddMediaObject создает объект мультимедиа, помещает его на слайд и включает в состав коллекции Shapes.
Общий вид:
AddMediaObject(FileName, Left, Top, Width, Height),
где
- FileName - имя мультимедийного файла.
- Left, Top - координаты (в пунктах) левого верхнего угла объекта.
- Width, Height - размеры объекта в пунктах.
Метод AddOLEObject создает или загружает из файла OLE-объект, помещает его на слайд и включает в состав коллекции Shapes.
Общий вид:
AddOLEObject(Left, Top, Width, Height, ClassName, FileName,
DisplayAsIcon, IconFileName, IconIndex, IconLabel, Link),
где
- Left, Top - координаты (в пунктах) левого верхнего угла объекта.
- Width, Height - размеры объекта в пунктах.
- ClassName - имя класса, к которому относится объект.
- FileName - имя файла, где находится объект.
- DisplayAsIcon - разрешает (True) отображать объект в виде значка.
- IconFileName - имя файла, где находится значок.
- IconIndex - порядковый номер значка в файле.
- IconLabel - определяет текст надписи под значком.
- Link - разрешает (True) связать объект.
Метод AddPicture загружает из файла рисунок, помещает его на слайд и включает в состав коллекции Shapes.
Общий вид:
AddPicture(FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height),
где
- FileName - имя графического файла.
- LinkToFile - определяет, должен ли (True) рисунок быть связанным с файлом-первоисточником или же (False) является независимой копией.
- SaveWithDocument - разрешает (True, обязательно в случае Связать = False) сохранять рисунок вместе с документом.
- Left, Top - координаты (в пунктах) левого верхнего угла рисунка.
- Width, Height - размеры рисунка в пунктах.
Метод AddShape создает автофигуру, помещает ее на слайд и включает в состав коллекции Shapes. Общий вид:
AddShape(Type, Left, Top, Width, Height),
где
- Type - константа, определяющая тип автофигуры. Возможные значения этого параметра перечислены на 272 шаге.
- Left, Top - координаты (в пунктах) левого верхнего угла объекта.
- Width, Height - размеры объекта в пунктах.
Метод AddTable создает таблицу указанного размера, помещает ее на слайд и включает в состав коллекции Shapes.
Общий вид:
AddTable(NumRows, NumColumns, Left, Top, Width, Height),
где
- NumRows - число строк в таблице.
- NumColumns - число столбцов в таблице.
- Left, Top - координаты (в пунктах) левого верхнего угла объекта.
- Width, Height - размеры объекта в пунктах.
Метод AddTextbox создает, включает в состав коллекции Shapes и помещает на слайд автофигуру с текстом.
Общий вид:
AddTextbox(Orientation, Left, Top, Width, Height),
где
- Orientation - константа, определяющая ориентацию текста надписи. Возможные значения:
msoTextOrientationDownward (3), msoTextOrientationHorizontal (1), msoTextOrientationHorizontalRotatedFarEast (6),
msoTextOrientationUpward (2), msoTextOrientationVertical (5), msoTextOrientationVerticalFarEast (4).
- Left, Top - координаты (в пунктах) левого верхнего угла текста.
- Width, Height - размеры автофигуры с текстом в пунктах.
Метод Paste выполняет вставку Shape-объекта из буфера обмена. Метод параметров не имеет.
Метод SelectAll выделяет все Shape-объекты на слайде. Метод параметров не имеет.
На следующем шаге мы рассмотрим объект Shape.
Предыдущий шаг
Содержание
Следующий шаг