확장 기능 옵션 가져오기
이 문서는 extension_get_options 함수에 대해 설명합니다. 이 함수는 주어진 이름의 확장에서 모든 옵션과 그 값을 포함하는 구조체를 반환합니다. 만약 제공된 확장 이름이 유효하지 않다면, 함수는 undefined를 반환합니다.
문법
extension_get_options(extension_name);
매개변수
| 매개변수 이름 | 타입 | 설명 |
|---|---|---|
| extension_name | String | 확장 자산의 이름을 문자열 형식으로 입력합니다. |
반환값
- 구조체(Struct): 주어진 확장의 모든 옵션과 해당 값들을 포함한 구조체를 반환합니다.
예제 코드
아래의 예제 코드는 특정 확장의 옵션 구조체를 가져오고, 활성화 여부를 읽어오는 방법을 보여줍니다.
var _options = extension_get_options("MyExtension");
var _enabled = _options.enabled;
이 코드는 "MyExtension"이라는 확장으로부터 옵션 구조체를 얻고, 그 구조체에서 활성화된 값(enabled)을 읽어옵니다.
활용 및 응용 예제
1. 다른 확장의 옵션 확인하기
여러 확장에서 옵션을 가져오는 방법을 보여줍니다. 각각의 확장에서 활성화된 상태를 확인할 수 있습니다.
var option1 = extension_get_options("ExtensionA");
var option2 = extension_get_options("ExtensionB");
if (option1.enabled) {
show_message("ExtensionA is enabled.");
}
if (option2.enabled) {
show_message("ExtensionB is enabled.");
}
2. 잘못된 확장 이름 처리하기
잘못된 확장 이름을 입력했을 때의 처리 예제입니다.
var _options = extension_get_options("InvalidExtension");
if (_options == undefined) {
show_message("잘못된 확장 이름입니다.");
} else {
// 유효한 옵션을 사용하십시오.
var _enabled = _options.enabled;
}
3. 모든 옵션 출력하기
확장에서 가져온 모든 옵션을 출력하는 방법입니다.
var _options = extension_get_options("MyExtension");
if (_options != undefined) {
for (var option in _options) {
show_message(option + ": " + string(_options[option]));
}
}
이 코드는 MyExtension의 모든 옵션 값을 순회하며 출력합니다.
이 문서를 통해 extension_get_options 함수의 사용법과 다양한 활용 예제를 이해하는 데 도움이 되기를 바랍니다.