TabGroupFromPoint メソッド

指定した画面座標にある MdiTabGroup を返します。指定したポイントにタブ グループが存在しない場合は null を返します。

シンタックス

Visual Basic

'宣言
 
Public Function TabGroupFromPoint( _
   ByVal point As Point _
) As MdiTabGroup

C#

public MdiTabGroup TabGroupFromPoint( 
   Point point
)

パラメータ

point

画面座標内の位置

戻り値の型

指定した座標にある MdiTabGroup、または null (VB では Nothing)。

解説

TabGroupFromPoint メソッドは、指定した画面座標にある MdiTabGroup を返します。MdiTabGroup がその領域を使用しない場合は null (VB では Nothing) を返します。

注: このメソッドは領域を占める MdiTabGroup をチェックします。そのため、指定したポイントが MdiTabGroupControl または SplitterBarControl の上にあるかどうかはわかりません。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTabs
Imports Infragistics.Win.UltraWinTabbedMdi

Private Sub Timer1_Tick(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Timer1.Tick
    Dim statusText As String = String.Empty
    Dim pt As Point = Control.MousePosition

    ' The 'TabGroupFromPoint' method takes screen coordinates
    ' so we can pass the coordinates from Control.MousePosition
    ' or Cursor.Position without converting them to client 
    ' coordinates.
    Dim tabGroup As MdiTabGroup = Me.ultraTabbedMdiManager1.TabGroupFromPoint(pt)

    ' if the mouse is not over an area managed by an MdiTabGroup,
    ' the method will return null
    If Not tabGroup Is Nothing Then
        ' if we're over a tab group, we may be over an MdiTab
        ' so use the TabFromPoint with the same screen 
        ' coordinates
        Dim tab As MdiTab = Me.ultraTabbedMdiManager1.TabFromPoint(pt)

        If Not tab Is Nothing Then
            ' if we were over a tab, display the actual
            ' text and tooltip it would display as well
            ' as some info about the tab group
            statusText = String.Format("Tab - ToolTip = {0}, Text = {1}, TabGroup = '{2}'", tab.ToolTipResolved, tab.TextResolved, tabGroup)
        Else
            ' otherwise, just use the tab group
            statusText = String.Format("TabGroup = '{0}'", tabGroup)
        End If
    End If

    If Me.StatusBar1.Text <> statusText Then
        Me.StatusBar1.Text = statusText
    End If
End Sub

C#

using Infragistics.Win;
using Infragistics.Win.UltraWinTabs;
using Infragistics.Win.UltraWinTabbedMdi;

private void timer1_Tick(object sender, System.EventArgs e)
{
	string statusText = string.Empty;
	Point pt = Control.MousePosition;

	// The 'TabGroupFromPoint' method takes screen coordinates
	// so we can pass the coordinates from Control.MousePosition
	// or Cursor.Position without converting them to client 
	// coordinates.
	MdiTabGroup tabGroup = this.ultraTabbedMdiManager1.TabGroupFromPoint(pt);

	// if the mouse is not over an area managed by an MdiTabGroup,
	// the method will return null
	if (tabGroup != null)
	{
		// if we're over a tab group, we may be over an MdiTab
		// so use the TabFromPoint with the same screen 
		// coordinates
		MdiTab tab = this.ultraTabbedMdiManager1.TabFromPoint(pt);

		if (tab != null)
		{
			// if we were over a tab, display the actual
			// text and tooltip it would display as well
			// as some info about the tab group
			statusText = string.Format("Tab - ToolTip = {0}, Text = {1}, TabGroup = '{2}'", tab.ToolTipResolved, tab.TextResolved, tabGroup);
		}
		else
		{
			// otherwise, just use the tab group
			statusText = string.Format("TabGroup = '{0}'", tabGroup);
		}
	}

	if (this.statusBar1.Text != statusText)
		this.statusBar1.Text = statusText;
}