テンプレートの変換
次の手順で、DataGridViewコントロールのレイアウトをGcMultiRowのテンプレートに変換します。
- GcMultiRowコントロールを選択し、コンテキスト メニュー（右クリックメニュー）から「DataGridViewから変換」を選択します。
- フォームにDataGridViewが配置されていない場合、コンテキスト メニューの「DataGridViewから変換」は選択することができません。
- 「DataGridViewから変換」ダイアログが表示されます。
- 「DataGridViewの選択」にフォームに配置されているDataGridViewから変換するコントロールを選択します。必要に応じて、「DataGridViewを削除する」、「変換後にテンプレートを表示する」のオプション項目を設定します。
- ［OK］ボタンをクリックして変換を行います。
変換時の方針
DataGridViewから変換は、次の方針に基づいて変換が行われます。
- 変換されるのはプロパティの設定のみです。イベントおよびメソッドは変換されません。
- 変換後、EnterキーにはSelectionActions.MoveDownプロパティが既定値として設定されます。
- DataGridViewコントロールの左上のヘッダは、CornerHeaderCellに変換されます。
- DataGridViewコントロールの行ヘッダは、RowHeaderCellに変換されます。
- DataGridViewコントロールに列が存在しない場合、変換後のテンプレートは空になります。
- DataGridViewから変換操作は、元に戻す／やり直し（アンドゥ／リドゥ）を行うことができます。
変換先のプロパティ
DataGridViewから変換を行うと、プロパティの変換先は次のようになります。
| DataGridView | GcMultiRow | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DataGridViewColumnクラス | ||||||||||||||||||||||
| Name | Cell.Name | |||||||||||||||||||||
| AutoSizeMode | - | |||||||||||||||||||||
| ColumnType | - | |||||||||||||||||||||
| DataPropertyName | Cell.DataField | |||||||||||||||||||||
| DefaultCellStyle | Cell.Style | |||||||||||||||||||||
| DividerWidth | - | |||||||||||||||||||||
| FillWeight | - | |||||||||||||||||||||
| Frozen | GcMultiRow.FreezeLeftCellIndex | |||||||||||||||||||||
| MinimumWidth | Cell.MinimumSize.Width | |||||||||||||||||||||
| ReadOnly | Cell.ReadOnly | |||||||||||||||||||||
| DataGridViewColumn.ResizableおよびDataGridView.ColumnHeadersHeightSizeMode | ColumnHeaderCell.ResizeMode 変換後のColumnHeaderCell.ResizeModeプロパティは、条件によって次の値が設定されます。
| |||||||||||||||||||||
| SortMode | ColumnHeaderCell.SortMode 変換後のColumnHeaderCell.SortModeプロパティは、条件によって次の値が設定されます。
| |||||||||||||||||||||
| ToolTipText | Cell.ToolTipText | |||||||||||||||||||||
| Visible | - | |||||||||||||||||||||
| Width | Cell.Width | |||||||||||||||||||||
| DataGridViewTextBoxColumnクラス | ||||||||||||||||||||||
| MaxInputLength | TextBoxCell.MaxLength | |||||||||||||||||||||
| DataGridViewButtonColumnクラス | ||||||||||||||||||||||
| FlatStyle | ButtonCell.FlatStyle | |||||||||||||||||||||
| Text | DataGridViewButtonColumn.UseColumnTextForButtonValueプロパティにTrueが設定されている場合、ButtonCell.Valueプロパティに変換されます。 それ以外の場合、DataGridViewButtonColumn.Textプロパティは無視されます。 | |||||||||||||||||||||
| UseColumnTextForButtonValue | - | |||||||||||||||||||||
| DataGridViewCheckBoxColumnクラス | ||||||||||||||||||||||
| - | CheckBoxCell.CheckAlignプロパティはMiddleCenterが設定されます。 | |||||||||||||||||||||
| FalseValue | CheckBoxCell.FalseValue | |||||||||||||||||||||
| FlatStyle | CheckBoxCell.FlatStyle | |||||||||||||||||||||
| IndeterminateValue | CheckBoxCell.IndeterminateValue | |||||||||||||||||||||
| ThreeState | CheckBoxCell.ThreeState | |||||||||||||||||||||
| TrueValue | CheckBoxCell.TrueValue | |||||||||||||||||||||
| DataGridViewComboBoxColumnクラス | ||||||||||||||||||||||
| AutoComplete | ComboBoxCell.AutoCompleteModeおよびComboBoxCell.AutoCompleteSource DataGridViewComboBoxColumn.AutoCompleteプロパティの設定値によって、ComboBoxCell.AutoCompleteModeプロパティ、およびComboBoxCell.AutoCompleteSourceプロパティは、次の値が設定されます。
| |||||||||||||||||||||
| DisplayMember | ComboBoxCell.DisplayMember | |||||||||||||||||||||
| DisplayStyle および DisplayStyleForCurrentCellOnly | ComboBoxCell.ShowDropDownButton DataGridViewComboBoxColumn.DisplayStyleプロパティ、およびDataGridViewComboBoxColumn.DisplayStyleForCurrentCellOnlyの設定値によって、ComboBoxCell.ShowDropDownButtonプロパティは、次の値が設定されます。
| |||||||||||||||||||||
| DropDownWidth | ComboBoxCell.DropDownWidth | |||||||||||||||||||||
| FlatStyle | ComboBoxCell.FlatStyle | |||||||||||||||||||||
| Items | ComboBoxCell.Items | |||||||||||||||||||||
| MaxDropDownItems | ComboBoxCell.MaxDropDownItems | |||||||||||||||||||||
| Sorted | ComboBoxCell.Sorted | |||||||||||||||||||||
| ValueMember | ComBoxCell.ValueMember | |||||||||||||||||||||
| DataGridViewImageColumnクラス | ||||||||||||||||||||||
| Description | - | |||||||||||||||||||||
| ImageLayout | ImageCell.Layout DataGridViewImageColumn.ImageLayoutプロパティがNotSetの場合、ImageCell.LayoutプロパティはImageCellLayout.Normalが設定されます。 | |||||||||||||||||||||
| DataGridViewLinkColumnクラス | ||||||||||||||||||||||
| ActiveLinkColor | LinkLabelCell.ActiveLinkColor | |||||||||||||||||||||
| LinkBehavior | LinkLabelCell.LinkBehavior | |||||||||||||||||||||
| LinkColor | LinkLabelCell.LinkColor | |||||||||||||||||||||
| Text | DataGridViewLinkColumn.UseColumnTextForLinkValueプロパティにTrueが設定されている場合、LinkLabelCell.Valueプロパティに変換されます。 それ以外の場合、DataGridViewLinkColumn.Textプロパティは無視されます。 | |||||||||||||||||||||
| TrackVisitedState | LinkLabelCell.TrackVisitedState | |||||||||||||||||||||
| UseColumnTextForLinkValue | - | |||||||||||||||||||||
| VisitedLinkColor | LinkLabelCell.VisitedLinkColor | |||||||||||||||||||||
| DataGridViewCellStyleクラス | ||||||||||||||||||||||
| NullValue | CellStyle.NullValue | |||||||||||||||||||||
| Format | CellStyle.Format | |||||||||||||||||||||
| Alignment | CellStyle.TextAlign | |||||||||||||||||||||
| Padding | CellStyle.Padding | |||||||||||||||||||||
| WrapMode | CellStyle.WordWrapおよびCellStyle.MultiLine DataGridViewCellStyle.WrapModeプロパティの設定により、CellStyle.WordWrapプロパティ、およびCellStyle.MultiLineプロパティは、次の値が設定されます。
| |||||||||||||||||||||
| BackColor | CellStyle.BackColor | |||||||||||||||||||||
| Font | CellStyle.Font | |||||||||||||||||||||
| ForeColor | CellStyle.ForeColor | |||||||||||||||||||||
| SelectionBackColor | CellStyle.SelectionBackColor | |||||||||||||||||||||
| SelectionForeColor | CellStyle.SelectionForeColor | |||||||||||||||||||||
| DataGridView クラス | ||||||||||||||||||||||
| Name | - | |||||||||||||||||||||
| AccessibleDescription | GcMultiRow.AccessibleDescription | |||||||||||||||||||||
| AccessibleName | GcMultiRow.AccessibleName | |||||||||||||||||||||
| AccessibleRole | GcMultiRow.AccessibleRole | |||||||||||||||||||||
| AllowDrop | GcMultiRow.AllowDrop | |||||||||||||||||||||
| AllowUserToAddRows | GcMultiRow.AllowUserToAddRows | |||||||||||||||||||||
| AllowUserToDeleteRows | GcMultiRow.AllowUserToDeleteRows | |||||||||||||||||||||
| AllowUserToOrderColumns | - | |||||||||||||||||||||
| AllowUserToResizeRowsおよびAllowUserToResizeColumns | GcMultiRow.AllowUserToResize DataGridView.AllowUserToResizeRowsプロパティ、およびDataGridView.AllowUserToResizeColumnsプロパティにどちらもFalseが設定されている場合、GcMultiRow.AllowUserToResizeプロパティにはFalseが設定されます。 それ以外の場合、GcMultiRow.AllowUserToResizeプロパティにはTrueが設定されます。 | |||||||||||||||||||||
| AlternatingRowsDefaultCellStyle | GcMultiRow.AlternatingRowsDefaultCellStyle | |||||||||||||||||||||
| Anchor | GcMultiRow.Anchor | |||||||||||||||||||||
| AutoSizeColumnsMode | GcMultiRow.HorizontalAutoSizeMode 変換後のGcMultiRow.HorizontalAutoSizeModeプロパティは、条件によって次の値が設定されます。
| |||||||||||||||||||||
| AutoSizeRowsMode | - | |||||||||||||||||||||
| BackgroundColor | GcMultiRow.BackColor | |||||||||||||||||||||
| BorderStyle | GcMultiRow.BorderStyle | |||||||||||||||||||||
| CausesValidation | GcMultiRow.CausesValidation | |||||||||||||||||||||
| CellBorderStyle | 変換後のGcMultiRowのCellStyle.Borderの色は、条件によって次の値が設定されます。
| |||||||||||||||||||||
| ClipboardCopyMode | GcMultiRow.AllowClipBoardおよびGcMultiRow.ClipboardCopyModeM 変換後のGcMultiRow.AllowClipBoardプロパティ、およびGcMultiRow.ClipboardCopyModeプロパティは、条件によって次の値が設定されます。
| |||||||||||||||||||||
| ColumnHeadersBorderStyle | - | |||||||||||||||||||||
| ColumnHeadersDefaultCellStyle | GcMultiRow.ColumnHeadersDefaultHeaderCellStyle | |||||||||||||||||||||
| ColumnHeadersHeight | ColumnHeaderSection.Height | |||||||||||||||||||||
| ResizableおよびColumnHeadersHeightSizeMode | ColumnHeaderCell.ResizeMode 変換後のColumnHeaderCell.ResizeModeプロパティは、条件によって次の値が設定されます。
| |||||||||||||||||||||
| ColumnHeadersVisible | ColumnHeaderSection.Visible | |||||||||||||||||||||
| Columns | GcMultiRow.Template | |||||||||||||||||||||
| ContextMenuStrip | GcMultiRow.ContextMenuStrip | |||||||||||||||||||||
| Cursor | GcMultiRow.Cursor | |||||||||||||||||||||
| DataMember | GcMultiRow.DataMember | |||||||||||||||||||||
| DataSoruce | GcMultiRow.DataSource | |||||||||||||||||||||
| DefaultCellStyle | GcMultiRow.DefaultCellStyle | |||||||||||||||||||||
| Dock | GcMultiRow.Dock | |||||||||||||||||||||
| EditMode | GcMultiRow.EditMode 変換後のGcMultiRow.EditModeプロパティは、条件によって次の値が設定されます。
| |||||||||||||||||||||
| Enabled | GcMultiRow.Enabled | |||||||||||||||||||||
| EnableHeadersVisualStyles | - | |||||||||||||||||||||
| - | GcMultiRow.FreezeLinesプロパティはLine.Emptyが設定されます。 | |||||||||||||||||||||
| GenerateMember | - | |||||||||||||||||||||
| GridColor | Cell.Border.Line.Color | |||||||||||||||||||||
| ImeMode | GcMultiRow.DefaulCellStyle.ImeMode | |||||||||||||||||||||
| Location | 変換時にDataGridViewを削除する場合、GcMultiRow.Locaitonに設定されます。 それ以外は何もしません。 | |||||||||||||||||||||
| Locked | - | |||||||||||||||||||||
| Margin | GcMultiRow.Margin | |||||||||||||||||||||
| MaximumSize | GcMultiRow.MaximumSize | |||||||||||||||||||||
| MinimumSize | GcMultiRow.MinimumSize | |||||||||||||||||||||
| Modifiers | - | |||||||||||||||||||||
| MultiSelect | GcMultiRow.MultiSelect | |||||||||||||||||||||
| ReadOnly | GcMultiRow.ReadOnly | |||||||||||||||||||||
| RightToLeft | - | |||||||||||||||||||||
| RowHeadersBorderStyle | - | |||||||||||||||||||||
| RowHeadersDefaultCellStyle | GcMultiRow.RowsDefaultHeaderCellStyle | |||||||||||||||||||||
| RowHeadersVisible | - | |||||||||||||||||||||
| RowHeadersWidth | RowHeaderCell.Width | |||||||||||||||||||||
| RowTemplate.ResizableおよびRowHeadersWidthSizeMode | RowHeaderCell.ResizeMode 変換後のRowHeaderCell.ResizeModeプロパティは、条件によって次の値が設定されます。
| |||||||||||||||||||||
| ScrollBars | GcMultiRow.ScrollBars | |||||||||||||||||||||
| - | GcMultiRow.ScrollBarModeプロパティはAutomaticが設定されます。 | |||||||||||||||||||||
| SelectionMode | DataGridView.SelectionModeプロパティがFullRowSelectの場合、GcMultiRow.ViewModeプロパティにViewMode.Rowが設定されます。 それ以外は、ViewMode.Defaultが設定されます。 | |||||||||||||||||||||
| ShowCellErrors | GcMultiRow.ShowCellErrors | |||||||||||||||||||||
| ShowCellToolTips | GcMultiRow.ShowCellToolTips | |||||||||||||||||||||
| ShowEditingIcon | GcMultiRow.ShowEditingIcon | |||||||||||||||||||||
| ShowRowErrors | GcMultiRow.ShowRowErrors | |||||||||||||||||||||
| Size | GcMultiRow.Size | |||||||||||||||||||||
| StandardTab | 変換後のGcMultiRowのTabキー、およびShift+Tabキーには、条件によって次のアクションが割り当てられます。
| |||||||||||||||||||||
| TabIndex | GcMultiRow.TabIndex | |||||||||||||||||||||
| TabStop | GcMultiRow.TabStop | |||||||||||||||||||||
| Tag | GcMultiRow.Tag | |||||||||||||||||||||
| UseWaitCursor | GcMultiRow.UseWaitCursor | |||||||||||||||||||||
| VirtualMode | GcMultiRow.VirtualMode | |||||||||||||||||||||
| Visible | GcMultiRow.Visible | |||||||||||||||||||||