Main Content

get

查询图形对象属性

    说明

    get(h) 在命令行窗口中显示指定的图形对象 h 的属性和属性值。h 必须为单个对象。如果 h 为空 ([ ]),则 get 不执行任何操作,也不返回错误或警告。

    示例

    s = get(h) 返回一个结构体,该结构体包含指定的图形对象 h 的所有属性和属性值。如果 h 是一个由对象组成的向量,则 get 返回 h 中所有对象的属性和值。如果 h 为空 ([ ]),则 get 不执行任何操作,也不返回错误或警告。

    v = get(h,propertyNames) 返回指定的图形对象 h 的指定属性的值。

    • 如果 h 是单个对象并且 propertyNames 是指定一个属性的字符串或字符向量,则 get 返回指定属性的值。如果 h 是单个对象并且 propertyNames 是指定一个或多个属性的元胞数组,则 get 返回一个包含指定属性的值的 1×n 元胞数组,其中 npropertyNames 中属性的数量。

    • 如果 h 是一个由对象组成的向量,则 get 返回一个包含指定属性的值的 m×n 元胞数组,其中 mh 中的元素数,npropertyNames 中包含的属性数。

    示例

    s = get(h,"default") 返回一个结构体,其中包含为指定对象定义的所有默认属性值。

    示例

    s = get(groot,"factory") 返回一个结构体,其中包含图形根对象 groot 的所有用户可设置属性的出厂定义值。

    v = get(h,defaultTypeProperty) 返回指定图形对象 h 的指定属性和对象类型的默认值。defaultTypeProperty 是用引号引起来的单词 default 与对象类型(如 Figure)和属性名称(如 Color)的串联形式。例如,v = get(groot,"defaultFigureColor") 返回图形根对象 grootFigure 对象的 Color 属性的默认值。

    示例

    v = get(groot,factoryTypeProperty) 返回图形根对象 groot 的指定属性和对象类型的出厂定义值。factoryTypeProperty 是用引号引起来的单词 factory 与对象类型(如 Figure)和属性名称(如 Color)的串联形式。例如,v = get(groot,"factoryFigureColor") 返回 Figure 对象的 Color 属性的出厂定义值。

    示例

    示例

    全部折叠

    创建一个线图并以 p 形式返回 Line 对象。列出对象的所有属性和当前值。

    p = plot(1:10);

    Figure contains an axes object. The axes object contains an object of type line.

    get(p)
          AffectAutoLimits: on
        AlignVertexCenters: off
                Annotation: [1x1 matlab.graphics.eventdata.Annotation]
              BeingDeleted: off
                BusyAction: 'queue'
             ButtonDownFcn: ''
                  Children: [0x0 GraphicsPlaceholder]
                  Clipping: on
                     Color: [0 0.4470 0.7410]
                 ColorMode: 'auto'
               ContextMenu: [0x0 GraphicsPlaceholder]
                 CreateFcn: ''
           DataTipTemplate: [1x1 matlab.graphics.datatip.DataTipTemplate]
                 DeleteFcn: ''
               DisplayName: ''
          HandleVisibility: 'on'
                   HitTest: on
             Interruptible: on
                  LineJoin: 'round'
                 LineStyle: '-'
             LineStyleMode: 'auto'
                 LineWidth: 0.5000
                    Marker: 'none'
           MarkerEdgeColor: 'auto'
           MarkerFaceColor: 'none'
             MarkerIndices: [1 2 3 4 5 6 7 8 9 10]
                MarkerMode: 'auto'
                MarkerSize: 6
                    Parent: [1x1 Axes]
             PickableParts: 'visible'
                  Selected: off
        SelectionHighlight: on
               SeriesIndex: 1
               SourceTable: [0x0 table]
                       Tag: ''
                      Type: 'line'
                  UserData: []
                   Visible: on
                     XData: [1 2 3 4 5 6 7 8 9 10]
                 XDataMode: 'auto'
               XDataSource: ''
                 XVariable: ''
                     YData: [1 2 3 4 5 6 7 8 9 10]
                 YDataMode: 'manual'
               YDataSource: ''
                 YVariable: ''
                     ZData: [1x0 double]
                 ZDataMode: 'auto'
               ZDataSource: ''
                 ZVariable: ''
    

    创建一个线图并以 p 形式返回 Line 对象。获取 LineWidth 属性的当前值。

    p = plot(1:10);

    Figure contains an axes object. The axes object contains an object of type line.

    get(p,"LineWidth")
    ans = 
    0.5000
    

    创建一个标题为 My App 的图窗。获取该图窗的 NamePositionColor 属性的当前值。

    fig = uifigure("Name","My App");

    props = {"Name","Position","Color"};
    get(fig,props)
    ans=1×3 cell array
        {'My App'}    {[348 376 583 437]}    {[0.9400 0.9400 0.9400]}
    
    

    获取根上为所有图形对象定义的默认值。

    get(groot,"default")
    ans = struct with fields:
                 defaultFigurePosition: [348 376 583 437]
        defaultFigurePaperPositionMode: 'auto'
                  defaultFigureVisible: off
                  defaultFigureToolBar: 'none'
                  defaultFigureMenuBar: 'none'
              defaultFigureWindowStyle: 'normal'
    
    

    创建一个红色线图,并将 Line 对象以 p 形式返回。

    p = plot(1:10,"Color","red");

    Figure contains an axes object. The axes object contains an object of type line.

    获取为 p 定义的 Color 属性的当前值和默认值。

    get(p,"Color")
    ans = 1×3
    
         1     0     0
    
    
    get(p,"defaultLineColor")
    ans = 1×3
    
         0     0     0
    
    

    获取在根上为所有 Line 对象定义的 MarkerSize 属性的出厂定义值。

    get(groot,"factoryLineMarkerSize")
    ans = 
    6
    

    输入参数

    全部折叠

    图形对象,指定为单个对象或对象向量。

    注意

    不要对 Java® 对象使用 get 函数,因为这会导致内存泄漏。有关详细信息,请参阅Access Public and Private Data

    属性名称,指定为字符串标量、字符向量或元胞数组。

    默认属性名称,指定为字符串标量或字符向量。defaultTypeProperty 是用引号引起来的单词 default 与对象类型(如 Figure)和属性名称(如 Color)的串联形式。

    示例: get(groot,"defaultFigureColor")

    出厂属性名称,指定为字符串标量或字符向量。factoryTypeProperty 是用引号引起来的单词 factory 与对象类型(如 Figure)和属性名称(如 Color)的串联形式。

    示例: get(groot,"factoryFigureColor")

    输出参量

    全部折叠

    属性名称及其值,以结构体形式返回。在此结构体中,字段名称为对象属性名称,字段值为对应的属性值。

    属性值,以任何数据类型的单个值或元胞数组形式返回。

    版本历史记录

    在 R2006a 之前推出

    另请参阅

    函数