Simulink.Annotation
Créer et spécifier les propriétés des annotations de texte, d’image et de zone
Description
Les annotations sont des éléments visuels que vous pouvez utiliser pour ajouter des notes descriptives et des légendes à votre modèle. Vous pouvez y accéder et les convertir en objets Simulink.Annotation de manière programmatique.
Pour obtenir un objet Simulink.Annotation existant, sélectionnez l’annotation. Ensuite, utilisez la fonction getCurrentAnnotation.
Création
Plusieurs méthodes sont disponibles pour la création d’un objet Simulink.Annotation.
Pour créer un objet
Annotationde manière programmatique, utilisez la fonctionSimulink.Annotationdécrite sur cette page.Pour créer un objet
Annotationde manière interactive, consultez Annotate Models.
Description
a = Simulink.Annotation(path,Name,Value)Simulink.Annotation('model/annotation','BackgroundColor','yellow') crée une annotation avec un arrière-plan jaune. Vous pouvez spécifier plusieurs paires nom-valeur. Placez chaque nom de propriété entre guillemets.
Arguments en entrée
Propriétés
Fonctions d'objet
Exemples
Cet exemple indique comment créer, modifier et afficher une annotation de manière programmatique.
Ouvrez un nouveau modèle.
open_system(new_system)
Créez une annotation avec les propriétés par défaut à l’aide de la fonction Simulink.Annotation.
a = Simulink.Annotation(gcs,'This is an annotation.');
Après avoir créé l’annotation, utilisez la notation pointée pour définir la valeur des propriétés. Par exemple, appliquez une police de 18 points et un arrière-plan jaune à l’annotation.
a.FontSize = 18;
a.BackgroundColor = 'yellow';Pour afficher et mettre brièvement en évidence la nouvelle annotation, utilisez la fonction view.
view(a)
Créez un nouveau modèle nommé CreateAnnotationModel et ouvrez-le.
new_system('CreateAnnotationModel') open_system('CreateAnnotationModel')
Utilisez la fonction Simulink.Annotation pour créer une annotation avec une taille de police de 18 points et un arrière-plan bleu clair.
a = Simulink.Annotation(... 'CreateAnnotationModel/This is an annotation.', ... 'FontSize',18, ... 'BackgroundColor','lightblue');
Conseils
Pour modifier une annotation existante de manière programmatique, utilisez la fonction
find_systempour obtenir le handle d’annotation, puis la fonctionget_parampour obtenir l’objet. Par exemple :h = find_system(gcs,'FindAll','on','Type','annotation'); a1 = get_param(h(1),'Object');
Si une annotation a invoqué une fonction de callback en cours d’exécution actuellement, utilisez
getCallbackAnnotationpour l’identifier. La fonction renvoie l’objetAnnotationcorrespondant. Cette fonction est également utile si vous écrivez une fonction de callback dans un fichier MATLAB distinct qui contient plusieurs appels de callback.
Fonctionnalité alternative
Vous pouvez également créer des annotations à l’aide de la fonction add_block. Par exemple :
add_block('built-in/Note','model/This is a note.','BackgroundColor','yellow')crée une annotation de note avec un arrière-plan jaune.add_block('built-in/Area','model/This is an Area.','Position',[120,100,230,200])crée une annotation de zone à la position spécifiée.
Pour créer une annotation et modifier ses propriétés de manière interactive, consultez Annotate Models.
Historique des versions
Introduit avant R2006a
