Skip to content

Moved 'How-tos/D for Win32' to wiki #496

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
1 commit merged into from
Feb 23, 2014
Merged

Moved 'How-tos/D for Win32' to wiki #496

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
137 changes: 2 additions & 135 deletions windows.dd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,141 +2,8 @@ Ddoc

$(D_S D for Win32,

$(P This describes the D implementation for 32 bit Windows systems.
Naturally,
Windows specific D features are not portable to other platforms.
)

$(P Instead of the:)

$(CCODE
#include <windows.h>
)
$(P of C, in D there is:)


--------------------
import core.sys.windows.windows;
--------------------


$(H2 Calling Conventions)

$(P In C, the Windows API calling conventions are $(CODE __stdcall).
In D, it is simply:
)

--------------------
extern (Windows)
{
/* ... function declarations ... */
}
--------------------


$(P The Windows linkage attribute sets both the calling convention
and the name mangling scheme to be compatible with Windows.
)

$(P For functions that in C would be $(CODE __declspec(dllimport)) or
$(CODE __declspec(dllexport)), use the $(CODE export) attribute:
)

--------------------
export void func(int foo);
--------------------

$(P If no function body is given, it's imported. If a function body
is given, it's exported.
)

$(H2 Windows Executables)

$(P Windows GUI applications can be written with D.
A sample such can be found in $(D $(DMDDIR)\samples\d\winsamp.d)
)

$(P These are required:)

$(OL

$(LI Instead of a $(CODE main) function serving as the entry point,
a $(CODE WinMain) function is needed.
)

$(LI $(CODE WinMain) must follow this form:

--------------------
import core.runtime;
import core.sys.windows.windows;
import std.string;

extern (Windows)
int WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpCmdLine, int nCmdShow)
{
int result;

void exceptionHandler(Throwable e) {
throw e;
}

try
{
Runtime.initialize(&exceptionHandler);
result = myWinMain(hInstance, hPrevInstance, lpCmdLine, nCmdShow);
Runtime.terminate(&exceptionHandler);
}
catch (Throwable e) // catch any uncaught exceptions
{
MessageBoxA(null, e.toString().toStringz(), "Error",
MB_OK | MB_ICONEXCLAMATION);
result = 0; // failed
}

return result;
}

int myWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpCmdLine, int nCmdShow)
{
// ... insert user code here ...
return 0;
}
--------------------


The $(D myWinMain()) function is where the user code goes, the
rest of $(D WinMain) is boilerplate to initialize and shut down
the D runtime system.
)

$(LI A $(CODE .def)
($(LINK2 http://www.digitalmars.com/ctg/ctgDefFiles.html, Module Definition File))
with at least the following
two lines in it:

$(MODDEFFILE
EXETYPE NT
SUBSYSTEM WINDOWS
)

Without those, Win32 will open a text console window whenever
the application is run.
)

$(LI The presence of $(D WinMain()) is recognized by the compiler
causing it to emit a reference to
$(LINK2 http://www.digitalmars.com/ctg/acrtused.html, __acrtused_dll)
and the phobos.lib runtime library.
)

)

$(H2 Windows Programming Examples)

A collection of over 140 Windows D programming code examples is available at
$(LINK2 https://github.com/AndrejMitrovic/DWindowsProgramming, this Github repository.)
This page has been moved to
$(LINK2 http://wiki.dlang.org/D_for_Win32, http://wiki.dlang.org/D_for_Win32)

)

Expand Down