AddButton
public RibbonButton AddButton(string groupName, string name, string text, Image image, RibbonItemSize size, EventHandler click)
지정 그룹 맨 뒤에 버튼 추가 — 같은 이름이 있으면 기존 버튼을 반환합니다
Parameters
| Name | Type | Description |
|---|---|---|
| groupName | string | 대상 그룹 이름 |
| name | string | 버튼 이름 (고유해야 함, "탭이름.xxx" 권장) |
| text | string | 버튼 표시 텍스트 (툴팁에도 사용) |
| image | Image | 버튼 아이콘 (큰 버튼용 이미지는 반환 객체의 LargeImage로 별도 지정 가능) |
| size | RibbonItemSize | 버튼 크기 (Large/Small) |
| click | EventHandler | 클릭 시 실행할 핸들러 (null 허용 — 반환 객체의 Click으로 나중에 구독 가능) |
Returns
| Type | Description |
|---|---|
| RibbonButton | 추가(또는 기존) 버튼 (그룹이 없거나 이름이 다른 요소와 충돌하면 null) |
Examples
// VIZCore3DX.NET Control
private VIZCore3DX.NET.VIZCore3DXControl vizcore3dx;
private void Example()
{
// 기본 제공 사용자 정의 탭의 그룹에 버튼 추가 + 클릭 동작 연결
vizcore3dx.Ribbon.AddGroup("custom", "custom.tools", "도구");
System.Drawing.Image icon = System.Drawing.Image.FromFile("C:\\Temp\\run.png");
VIZCore3DX.NET.Controls.Ribbon.RibbonButton btn = vizcore3dx.Ribbon.AddButton(
"custom.tools", "custom.run", "실행",
icon, VIZCore3DX.NET.Controls.Ribbon.RibbonItemSize.Large,
(s, e) => MessageBox.Show("사용자 정의 기능 실행"));
// 반환 객체로 추가 제어
btn.Enabled = true;
}