RawFrame

Propriété Shape.RawFrame

Renvoie ou définit les propriétés de la frame de forme brute. Lecture/écriture IShapeFrame.

public IShapeFrame RawFrame { get; set; }

Exemples

Le code qui tente d’assigner une frame non définie à IShape.Frame n’a pas de sens dans le cas général (particulièrement lorsque le groupe parent GroupShape est imbriqué plusieurs fois dans d’autres GroupShape). Par exemple :

IShape shape = ...;
shape.Frame = new ShapeFrame(float.NaN, float.NaN, float.NaN, float.NaN, NullableBool.NotDefined, NullableBool.NotDefined, float.NaN);

ou

slide.Shapes.AddAutoShape(ShapeType.RoundCornerRectangle, float.NaN, float.NaN, float.NaN, float.NaN);

Un tel code peut entraîner des situations peu claires. Des restrictions ont donc été ajoutées pour l’utilisation de valeurs non définies pour IShape.Frame. Les valeurs de x, y, width, height, flipH, flipV et rotationAngle doivent être définies (pas float.NaN ou NullableBool.NotDefined). Le code exemple ci-dessus provoque maintenant une exception ArgumentException. Cela s’applique à ces cas d’utilisation :

IShape shape = ...;
shape.Frame = ...; // ne peut pas être non défini

IShapeCollection shapes = ...;
// les paramètres x, y, width, height ne peuvent pas être float.NaN :
{
    shapes.AddAudioFrameCD(...);
    shapes.AddAudioFrameEmbedded(...);
    shapes.AddAudioFrameLinked(...);
    shapes.AddAutoShape(...);
    shapes.AddChart(...);
    shapes.AddConnector(...);
    shapes.AddOleObjectFrame(...);
    shapes.AddPictureFrame(...);
    shapes.AddSmartArt(...);
    shapes.AddTable(...);
    shapes.AddVideoFrame(...);
    shapes.InsertAudioFrameEmbedded(...);
    shapes.InsertAudioFrameLinked(...);
    shapes.InsertAutoShape(...);
    shapes.InsertChart(...);
    shapes.InsertConnector(...);
    shapes.InsertOleObjectFrame(...);
    shapes.InsertPictureFrame(...);
    shapes.InsertTable(...);
    shapes.InsertVideoFrame(...);
}

Mais les propriétés de frame IShape.RawFrame peuvent être non définies. Cela a du sens lorsque la forme est liée à un espace réservé. Dans ce cas, les valeurs de frame de forme non définies sont remplacées par celles de la forme d’espace réservé parent. S’il n’y a pas de forme d’espace réservé parent pour cette forme, alors cette forme utilise des valeurs par défaut lorsqu’elle évalue la frame effective basée sur son IShape.RawFrame. Les valeurs par défaut sont 0 et NullableBool.False pour x, y, width, height, flipH, flipV et rotationAngle. Par exemple :

IShape shape = ...; // la forme est liée à un espace réservé
shape.RawFrame = new ShapeFrame(float.NaN, float.NaN, 100, float.NaN, NullableBool.NotDefined, NullableBool.NotDefined, 0); // maintenant la forme hérite des valeurs x, y, height, flipH, flipV de l'espace réservé et remplace width=100 et rotationAngle=0.

Voir aussi

Presentation Rotation