Свойства и методы коллекции 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.



Вы можете оставить комментарий, или Трекбэк с вашего сайта.

Оставить комментарий