منبع اطلاعات

منبع اطلاعات

منبع اطلاعات
یک شی DataSource یا Scalar ، Array 1D ، Array 2D ، ChoiceList یک UnitSet یا GraphicsData است.
روش های اسکالر، آرایه 1 بعدی و آرایه 2 بعدی
روش های شرح داده شده در جدول زیر برای اشیاء Scalar ، Array 1D و Array 2D (از انواع String ، Boolean ، Integer ، Double ) قابل استفاده است. این روش ها برای دستکاری چنین اشیاء متغیری در طول زمان اجرا استفاده می شوند.
 
نام
نحو
شرح
دریافت بولی
boolean getBoolean()
مقدار Boolean ذخیره شده در منبع داده را دریافت می کند.
getBooleanArray
boolean[] getBooleanArray()
مقدار آرایه بولی ذخیره شده در منبع داده را دریافت می کند.
getBooleanMatrix
boolean[][] getBooleanMatrix()
مقدار ماتریس بولی ذخیره شده در منبع داده را دریافت می کند.
getDouble
double getDouble()
مقدار دو برابر ذخیره شده در منبع داده را دریافت می کند.
getDoubleArray
double[] getDoubleArray()
مقدار آرایه دوگانه ذخیره شده در منبع داده را دریافت می کند.
getDoubleMatrix
double[][] getDoubleMatrix()
مقدار ماتریس دوگانه ذخیره شده در منبع داده را دریافت می کند.
رنگی
int getInt()
مقدار int ذخیره شده در منبع داده را دریافت می کند.
getIntArray
int[] getIntArray()
مقدار آرایه int ذخیره شده در منبع داده را دریافت می کند.
getIntMatrix
int[][] getIntMatrix()
مقدار ماتریس int ذخیره شده در منبع داده را دریافت می کند.
getString
String getString()
مقدار String ذخیره شده در منبع داده را دریافت می کند.
getStringArray
String[] getStringArray()
مقدار آرایه String ذخیره شده در منبع داده را دریافت می کند.
getStringMatrix
String[][] getStringMatrix()
مقدار ماتریس String ذخیره شده در منبع داده را دریافت می کند.
تنظیم
set(boolean value)
set(boolean[] value)
set(boolean[][] value)
set(double[] value)
set(double[] value)
set(double[][] value)
set(int value)
set(int[] value)
set(int[][] value)
set(String value)
set(String[] value)
set(String[][] value)
مقدار ذخیره شده در منبع داده را تنظیم کنید. روش های موجود به نوع اظهارنامه اساسی بستگی دارد.
کد مثال
// Get a scalar double declaration.
DataSource ds = app.declaration(“var”);
// The ‘var’ declaration is a scalar double so we use the getDouble method // to read its value.
double cur = ds.getDouble();
// Modifying the local field ‘cur’ does not affect the value stored in the // data source ‘ds’.
cur = cur + 1;
// Set the value of the data source.
ds.set(cur);
فهرست انتخاب و روش‌های مجموعه واحد
متدهای شرح داده شده در جدول زیر برای اشیاء ChoiceList و UnitSet قابل اجرا هستند . این روش ها برای دستکاری لیست های انتخاب و مجموعه واحدها در طول زمان اجرا استفاده می شوند.
 
نام
نحو
شرح
addListRow
addListRow(String value, String displayName, int row)
یک ردیف جدید با مقدار داده شده و نام نمایشی در ردیف مشخص شده (بر اساس 0) درج می کند.
appendListRow
appendListRow(String value, String displayName)
یک ردیف جدید با مقدار داده شده و نام نمایشی در انتهای لیست درج می کند.
getValue
String getValue(int row)
مقدار سطر داده شده (بر اساس 0) را برمی گرداند.
getDisplayName
String getDisplayName(int row)
نام نمایشی ردیف داده شده (بر اساس 0) را برمی گرداند.
getDisplayName
String getDisplayName(String value)
نام نمایشی ردیف با مقدار داده شده را برمی گرداند.
getValues
String[] getValues()
همه مقادیر را به صورت آرایه برمی گرداند.
getDisplayNames
String[] getDisplayNames()
همه نام های نمایش داده شده را به صورت آرایه برمی گرداند.
removeListRow
removeListRow(int row)
ردیف داده شده (بر اساس 0) را از لیست حذف می کند.
setListRow
setListRow(String value, String displayName, int row)
مقدار و نام نمایشی را برای ردیف داده شده (بر اساس 0) تنظیم می کند. اگر ردیف برابر با طول لیست باشد، یک ردیف جدید اضافه می شود.
setList
setList(String[] values, String[] displayNames)
همه مقادیر و نام‌های نمایشی را تنظیم می‌کند و محتوای فهرست انتخابی یا مجموعه واحد را جایگزین می‌کند.
setValue
setValue(String value, int row)
مقدار را برای ردیف داده شده (بر اساس 0) تنظیم می کند. اگر ردیف برابر با طول لیست باشد، یک ردیف جدید با مقدار و یک نام نمایشی خالی اضافه می شود.
setDisplayName
setDisplayName(String displayName, int row)
نام نمایشی را برای ردیف داده شده (بر اساس 0) تنظیم می کند. اگر ردیف برابر با طول لیست باشد، یک ردیف جدید با نام نمایشی و یک مقدار خالی اضافه می شود.
کد مثال
کد زیر رشته آلومینیوم 3004 را به لیست انتخاب اضافه می کند. توجه داشته باشید که فهرست انتخاب از 0 شروع می شود، در حالی که برچسب های مواد از 1 شروع می شود ( mat1 ، mat2 ، mat3 و mat4 ).
ChoiceList ChoiceList = getChoiceList(“choicelist1”);
ChoiceList.setListRow(“mat4″، “Aluminium 3004″، 3);
برای اطلاعات بیشتر در مورد استفاده از فهرست‌های انتخابی برای تغییر مواد، به کتاب مقدمه‌ای بر برنامه‌ساز مراجعه کنید.
روش‌های مجموعه واحد
هنگامی که شی یک UnitSet است ، روش های اضافی زیر نیز موجود است:
 
نام
نحو
شرح
getString
string getString()
مقدار فعلی انتخاب شده را برای مجموعه واحد برمی گرداند.
getString
string getString (String unitList)
واحد انتخاب شده را برای لیست واحد داده شده برمی گرداند.
تنظیم
set(String value)
واحد سوئیچ برای مجموعه واحد.
روش های داده های گرافیکی
هنگامی که شی یک GraphicsData است ، روش های زیر در دسترس هستند:
 
نام
نحو
شرح
getString
string getString (String name)
مقدار خاصیت مشخص شده را به صورت رشته برمی گرداند.
getDouble
double getDouble (String name)
مقدار ویژگی مشخص شده را به صورت یک مقدار دوبرابر برمی گرداند.
getDoubleArray
double[] getDoubleArray (String name)
مقدار ویژگی مشخص شده را به عنوان یک مقدار آرایه دوگانه برمی گرداند.
set
set(String name, String value)
set(String name, double value)
set(String name, double[] value)
مقدار جدیدی را برای ویژگی با نام مشخص شده تعیین می کند.
کلاس GraphicsData دارای ویژگی های زیر است:
 
ویژگی
ارزش
پیش فرض
شرح
coord
double[]
0, 0, 0
مکان نقطه ای داده های انتخاب شده آرایه ای از 1، 2، 3 یا 6 عنصر، به ترتیب مربوط به نمودار 1D، 2D، 3D، یا Smith.
depth
double
0
هنگام انتخاب داده ها در یک دامنه، در امتداد یک خط قرار بگیرید. مقادیر معتبر بین 0 و 1 هستند.
edim
domain | boundary
domain
سطح موجودیت هندسی
eval
double
0
ارزش ارزیابی داده های انتخاب شده
method
pointnormal | pointdir | twopoints | none
pointnormal
روش انتخاب نقطه در هندسه سه بعدی
twopoint
first | second
first
نقطه ای که در روش ورود خط دو نقطه ای انتخاب می شود.
کد نمونه
کد زیر انتخاب داده‌ها را برای شی graphics1 فعال می‌کند، آن را به شی graphicsdata1 متصل می‌کند و برخی ویژگی‌ها را روی شی graphicsdata1 تنظیم می‌کند :
app.form(“form1”).formObject(“graphics1”).set(“datapick”, true);
app.form(“form1”).formObject(“graphics1”).set(“datapicktarget”,
    app.declaration(“graphicsdata1”));
app.declaration(“graphicsdata1”).set(“edim”، “boundary”);
app.declaration(“graphicsdata1”).set(“method”، “pointdir”);