기본 제공 함수 호출
- 인수는 위치 기반이며 모두 필수입니다. 선택적 인수, 명명된 인수, 가변 길이 인수를 받는 기본 제공 함수는 없습니다. 참조의 매개 변수 이름은 레이블일 뿐입니다.
- 인수 수는 스크립트를 컴파일할 때 검사되므로, 수가 틀리면 아무것도 실행되기 전에 스크립트가 중지됩니다.
- 인수 형식은 호출이 실행될 때 검사되며, 한 가지 확대 변환을 제외하고는 정확히 일치해야
합니다. Real로 선언된 자리의 Integer는 산술 연산에서와 마찬가지로 해당 Real이 됩니다
(
MathSqrt(16)은 동작합니다). Integer로 선언된 자리의 Real이나 Text로 선언된 자리의 숫자 (UtilityPrint(42))는 Name: 인수 N의 형식이 잘못되었습니다. 오류로 작업을 중지합니다. Any로 표시된 매개 변수는 모든 형식을 받습니다. - 모든 기본 제공 함수는 값을 반환합니다. 대부분의 동작은 "성공했는지"를 뜻하는 Bool을 반환하며, 무시하거나 검사할 수 있습니다.
- 없는 대상은 오류가 아니라 정상적인 결과입니다. 찾지 못한 창은 null Window입니다. null
Window나 닫힌 창을
Window*기본 제공 함수에 전달하면 아무 동작도 하지 않고false,0또는""를 반환하므로, 찾지 못한 핸들에 창 호출을 연달아 해도 안전합니다. 컨텍스트 기본 제공 함수를 해당 트리거 밖에서 호출하면"",0,-1또는 null Window를 반환합니다. - 여러 결과는 열거한 다음 인덱스로 읽습니다.
WindowGetAllTopLevel(),FolderEnumerateAll(…),StringSplit(…),DisplayMonitorEnumeratedAll()같은 호출은 개수를 반환하고, 짝을 이루는…EnumeratedAt(i)/…PartAt(i)가0부터 개수 − 1까지의 항목i를 읽습니다. 각 함수군에는 스크립트 실행마다 캐시가 하나씩 있으며, 같은 함수군에서 다음 열거 호출을 하면 캐시가 대체됩니다. - 플러그 인이 자체 기본 제공 함수를 제공할 수 있습니다. 호출 방법은 같습니다. 스크립트를 컴파일할 때 플러그 인이 연결되어 있지 않으면 스크립트가 실행되지 않으며 알림에 그 이유가 표시됩니다.
n = WindowGetAllTopLevel(); // 개수를 반환하고 창 캐시를 채웁니다
for (i = 0; i < n; i = i + 1) {
w = WindowGetEnumeratedAt(i); // 해당 캐시의 항목 i
if (WindowGetVisible(w) && WindowGetTitle(w)) {
UtilityPrint(WindowGetExecutableName(w) + " - " + WindowGetTitle(w));
}
}