LayoutKind 列挙体
アンマネージ コードにエクスポートするときにオブジェクトのレイアウトを制御します。
名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文
メンバ
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: mscorlib (mscorlib.dll 内)
構文<SerializableAttribute> _ <ComVisibleAttribute(True)> _ Public Enumeration LayoutKind
メンバ| メンバ名 | 説明 | |
|---|---|---|
.gif) | Auto | ランタイムは、アンマネージ メモリ内のオブジェクトのメンバに対して適切なレイアウトを自動的に選択します。この列挙体メンバで定義されたオブジェクトは、マネージ コードの外に公開できません。公開しようとすると、例外が生成されます。 |
| Explicit | アンマネージ メモリ内にあるオブジェクトの各メンバの正確な位置は、明示的に制御されます。各メンバは FieldOffsetAttribute を使用して、その型内のフィールドの位置を指定する必要があります。 |
| Sequential | オブジェクトのメンバは、アンマネージ メモリにエクスポートするときに表示される順番に従ってレイアウトされます。メンバは、StructLayoutAttribute.Pack で指定したパッキングに従ってレイアウトされます。メンバは非連続にできます。 |
解説この列挙体は、StructLayoutAttribute で使用されます。共通言語ランタイムは既定で、Auto レイアウトを使用します。Auto 値にかかわるレイアウト関連の問題の発生を防ぐため、C#、Visual Basic、および C++ のコンパイラは、値型に対して Sequential レイアウトを指定します。
使用例PtInRect 関数のマネージ宣言の例を次に示します。この関数は、特定の点が四角形内に存在するかどうかを確認し、Point 構造体を Sequential レイアウトで定義し、Rect 構造体を Explicit レイアウトを定義します。
Enum Bool [False] = 0 [True] End Enum 'Bool <StructLayout(LayoutKind.Sequential)> _ Public Structure Point Public x As Integer Public y As Integer End Structure 'Point <StructLayout(LayoutKind.Explicit)> _ Public Structure Rect <FieldOffset(0)> Public left As Integer <FieldOffset(4)> Public top As Integer <FieldOffset(8)> Public right As Integer <FieldOffset(12)> Public bottom As Integer End Structure 'Rect Class LibWrapper <DllImport("user32.dll", CallingConvention := CallingConvention.StdCall)> _ Public Shared Function PtInRect(ByRef r As Rect, p As Point) As Bool End Function End Class 'LibWrapper Class TestApplication Public Shared Sub Main() Try Dim bPointInRect As Bool = 0 Dim myRect As New Rect() myRect.left = 10 myRect.right = 100 myRect.top = 10 myRect.bottom = 100 Dim myPoint As New Point() myPoint.x = 50 myPoint.y = 50 bPointInRect = LibWrapper.PtInRect(myRect, myPoint) If bPointInRect = Bool.True Then Console.WriteLine("Point lies within the Rect") Else Console.WriteLine("Point did not lies within the Rect") End If Catch e As Exception Console.WriteLine(("Exception : " + e.Message.ToString())) End Try End Sub 'Main End Class 'TestApplication
enum Bool { False = 0, True }; [StructLayout(LayoutKind.Sequential)] public struct Point { public int x; public int y; } [StructLayout(LayoutKind.Explicit)] public struct Rect { [FieldOffset(0)] public int left; [FieldOffset(4)] public int top; [FieldOffset(8)] public int right; [FieldOffset(12)] public int bottom; } class LibWrapper { [DllImport("user32.dll", CallingConvention=CallingConvention.StdCall)] public static extern Bool PtInRect(ref Rect r, Point p); }; class TestApplication { public static void Main() { try { Bool bPointInRect = 0; Rect myRect = new Rect(); myRect.left = 10; myRect.right = 100; myRect.top = 10; myRect.bottom = 100; Point myPoint = new Point(); myPoint.x = 50; myPoint.y = 50; bPointInRect = LibWrapper.PtInRect(ref myRect, myPoint); if(bPointInRect == Bool.True) Console.WriteLine("Point lies within the Rect"); else Console.WriteLine("Point did not lies within the Rect"); } catch(Exception e) { Console.WriteLine("Exception : " + e.Message); } } }
enum class Bool { False = 0, True }; [StructLayout(LayoutKind::Sequential)] value struct Point { public: int x; int y; }; [StructLayout(LayoutKind::Explicit)] value struct Rect { public: [FieldOffset(0)] int left; [FieldOffset(4)] int top; [FieldOffset(8)] int right; [FieldOffset(12)] int bottom; }; ref class LibWrapper { public: [DllImport("user32.dll",CallingConvention=CallingConvention::StdCall)] static Bool PtInRect( Rect * r, Point p ); }; int main() { try { Bool bPointInRect = (Bool)0; Rect myRect = Rect( ); myRect.left = 10; myRect.right = 100; myRect.top = 10; myRect.bottom = 100; Point myPoint = Point( ); myPoint.x = 50; myPoint.y = 50; bPointInRect = LibWrapper::PtInRect( &myRect, myPoint ); if ( bPointInRect == Bool::True ) Console::WriteLine( "Point lies within the Rect" ); else Console::WriteLine( "Point did not lie within the Rect" ); } catch ( Exception^ e ) { Console::WriteLine( "Exception : {0}", e->Message ); } }
enum Bool { False (0), True (1); } //Bool /** @attribute StructLayout(LayoutKind.Sequential) */ public class Point { public static int x; public static int y; } //Point /** @attribute StructLayout(LayoutKind.Explicit) */ public class Rect { /** @attribute FieldOffset(0) */ public int left; /** @attribute FieldOffset(4) */ public int top; /** @attribute FieldOffset(8) */ public int right; /** @attribute FieldOffset(12) */ public int bottom; } //Rect class LibWrapper { /** @attribute DllImport("user32.dll", CallingConvention = CallingConvention.StdCall) */ public static native Bool PtInRect(/** @ref */ Rect r, Point p); } //LibWrapper class TestApplication { public static void main(String[] args) { try { Bool bPointInRect = (Bool)0; Rect myRect = new Rect(); myRect.left = 10; myRect.right = 100; myRect.top = 10; myRect.bottom = 100; Point myPoint = new Point(); myPoint.x = 50; myPoint.y = 50; bPointInRect = LibWrapper.PtInRect(/** @ ref */ myRect, myPoint); if (bPointInRect.Equals(Bool.True)) { Console.WriteLine("Point lies within the Rect"); } else { Console.WriteLine("Point does not lie within the Rect"); } } catch (System.Exception e) { Console.WriteLine("Exception : " + e.get_Message()); } } //main } //TestApplication
プラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- LayoutKind 列挙体のページへのリンク
