Main Content

get

查询图形对象属性

全页折叠

    语法

    get(h)
    s = get(h)
    v = get(h,propertyNames)
    s = get(h,"default")
    s = get(groot,"factory")
    v = get(h,defaultTypeProperty)
    v = get(groot,factoryTypeProperty)

    说明

    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 元胞数组，其中 n 是 propertyNames 中属性的数量。

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

    示例

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

    示例

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

    v = get(h,defaultTypeProperty) 返回指定图形对象 h 的指定属性和对象类型的默认值。defaultTypeProperty 是用引号引起来的单词 default 与对象类型（如 Figure）和属性名称（如 Color）的串联形式。例如，v = get(groot,"defaultFigureColor") 返回图形根对象 groot 的 Figure 对象的 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 的图窗。获取该图窗的 Name、Position 和 Color 属性的当前值。

    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 之前推出

    另请参阅

    函数

    主题